User connections

Connections through the data API are used to link objects with each others


Some objects can only be accessed and/or created through connections since they have no point in existing on their own.

Here is the list of connections available through the user object.


Filters

Description

children

List of this user’s children. This connection joins an object of type user with a list of user objects.

features

List of videos featured by this user. This connection joins an object of type user with a list of video objects.

followers

List of this user’s followers. This connection joins an object of type user with a list of user objects.

following

List of users followed by this user. This connection joins an object of type user with a list of user objects.

likes

List of videos liked by the user. This connection joins an object of type user with a list of video objects.

parents

List of this user’s parents. This connection joins an object of type user with a list of user objects.

players

List of players created by this user This connection joins an object of type user with a list of player objects.

relations

List of user accounts related to this user through their parents. This connection joins an object of type user with a list of user objects.

subscriptions

List of videos from the channels the user follow. This connection joins an object of type user with a list of video objects.

videos

List of videos uploaded by this user. This connection joins an object of type user with a list of video objects.

watchlater

List of watch later videos. This connection joins an object of type user with a list of video objects.




children

List of this user’s children. This connection joins an object of type user with a list of user objects.

Action

Description

Read the user's children connection

You can retrieve the list of children connected to a user object by issuing a GET request to /me/children. You can specify the list of fields from the user objects to be returned using the fields parameter.

You can also see if any user is connected to an existing user object by issuing a GET request to /me/children/<USER_ID>. This will return a list containing only the connected user object or an empty list if it is not connected.

Create a user's children connection

You can connect children to an existing user object one by one by issuing multiple POST requests to /me/children/<USER_ID>.

Delete a user's children connection

You can disconnect children from a user object by issuing DELETE requests to /me/children/<USER_ID>.

You can also disconnect all children at once by issuing a POST request to /me/children with an empty ids query-string parameter.



features

List of videos featured by this user. This connection joins an object of type user with a list of video objects.

Action

Description

Read the user's features connection

You can retrieve the list of features connected to a user object by issuing a GET request to /me/features. You can specify the list of fields from the video objects to be returned using the fields parameter.

You can also see if any video is connected to an existing user object by issuing a GET request to /me/features/<VIDEO_ID>.

This will return a list containing only the connected video object or an empty list if it is not connected.

Create a user's features connection

You can connect features to an existing user object one by one by issuing multiple POST requests to /me/features/<VIDEO_ID>.

Delete a user's features connection

You can disconnect features from a user object by issuing DELETE requests to /me/features/<VIDEO_ID>.

You can also disconnect all features at once by issuing a POST request to /me/features with an empty ids query-string parameter.Read the user's children connection


followers

List of this user’s followers. This connection joins an object of type user with a list of user objects.

Action

Description

Read the user's followers connection

You can retrieve the list of followers connected to a user object by issuing a GET request to /me/followers.

You can specify the list of fields from the user objects to be returned using the fields parameter.


following

List of users followed by this user. This connection joins an object of type user with a list of user objects.

Action

Description

Read the user's following connection

You can retrieve the list of following connected to a user object by issuing a GET request to /me/following. You can specify the list of fields from the user objects to be returned using the fields parameter.

You can also see if any user is connected to an existing user object by issuing a GET request to /me/following/<USER_ID>. This will return a list containing only the connected user object or an empty list if it is not connected.

Create a user's following connection

You can connect following to an existing user object one by one by issuing multiple POST requests to /me/following/<USER_ID>.

Delete a user's following connection

You can disconnect following from a user object by issuing DELETE requests to /me/following/<USER_ID>. You can also disconnect all following at once by issuing a POST request to /me/following with an empty ids query-string parameter.



likes

List of videos liked by the user. This connection joins an object of type user with a list of video objects.

Action

Description

Read the user's likes connection

You can retrieve the list of likes connected to a user object by issuing a GET request to /me/likes. You can specify the list of fields from the video objects to be returned using the fields parameter.

You can also see if any video is connected to an existing user object by issuing a GET request to /me/likes/<VIDEO_ID>. This will return a list containing only the connected video object or an empty list if it is not connected.

Create a user's likes connection

You can connect likes to an existing user object one by one by issuing multiple POST requests to /me/likes/<VIDEO_ID>.

Delete a user's likes connection

You can disconnect likes from a user object by issuing DELETE requests to /me/likes/<VIDEO_ID>.

You can also disconnect all likes at once by issuing a POST request to /me/likes with an empty ids query-string parameter.



parents

List of this user’s parents. This connection joins an object of type user with a list of user objects.

Action

Description

Read the user's children connection

You can retrieve the list of children connected to a user object by issuing a GET request to /me/children. You can specify the list of fields from the user objects to be returned using the fields parameter.

You can also see if any user is connected to an existing user object by issuing a GET request to /me/children/<USER_ID>. This will return a list containing only the connected user object or an empty list if it is not connected.

Create a user's children connection

You can connect children to an existing user object one by one by issuing multiple POST requests to /me/children/<USER_ID>.

Delete a user's children connection

You can disconnect children from a user object by issuing DELETE requests to /me/children/<USER_ID>.

You can also disconnect all children at once by issuing a POST request to /me/children with an empty ids query-string parameter.


players

List of players created by this user This connection joins an object of type user with a list of player objects.

Action

Description

Read the user's players connection


You can retrieve the list of players connected to a user object by issuing a GET request to /me/players. You can specify the list of fields from the player objects to be returned using the fields parameter.

Create a user's players connection

You can create a new player object and automatically connect it to an existing user object by issuing a POST request to /me/players.

In return, you will receive a dict value containing the newly created object, including its identifier.

Delete a user's players connection

You can delete a player object connected to a user object the same way you would if it wasn't attached, that is by issuing a DELETE request to /player/<PLAYER_ID>.


relations

List of user accounts related to this user through their parents. This connection joins an object of type user with a list of user objects.

Action

Description

Read the user's relations connection

You can retrieve the list of relations connected to a user object by issuing a GET request to /me/relations. You can specify the list of fields from the user objects to be returned using the fields parameter.


subscriptions

List of videos from the channels the user follow. This connection joins an object of type user with a list of video objects.

ActionDescription
Read the user's subscriptions connectionYou can retrieve the list of subscriptions connected to a user object by issuing a GET request to /me/subscriptions. You can specify the list of fields from the video objects to be returned using the fields parameter.


videos

List of videos uploaded by this user. This connection joins an object of type user with a list of video objects.

Action

Description

Read the user's videos connection

You can retrieve the list of videos connected to a user object by issuing a GET request to /me/videos. You can specify the list of fields from the video objects to be returned using the fields parameter.

Create a user's videos connection

You can create a new video object and automatically connect it to an existing user object by issuing a POST request to /me/videos with the following parameters.

Type: STRING Parameter: content_provider Description: Content provider name.

Delete a user's videos connection

You can delete a video object connected to a user object the same way you would if it wasn't attached, that is by issuing a DELETE request to /video/<VIDEO_ID>.


watchlater

List of watch later videos. This connection joins an object of type user with a list of video objects.

Action

Description

Read the user's watchlater connection

You can retrieve the list of watchlater connected to a user object by issuing a GET request to /me/watchlater. You can specify the list of fields from the video objects to be returned using the fields parameter.

You can also see if any video is connected to an existing user object by issuing a GET request to /me/watchlater/<VIDEO_ID>. This will return a list containing only the connected video object or an empty list if it is not connected.

Create a user's watchlater connection

You can connect watchlater to an existing user object one by one by issuing multiple POST requests to /me/watchlater/<VIDEO_ID>.

Delete a user's watchlater connection

You can disconnect watchlater from a user object by issuing DELETE requests to /me/watchlater/<VIDEO_ID>. You can also disconnect all watchlater at once by issuing a POST request to /me/watchlater with an empty ids query-string parameter.