Insert
|
|||||
|
|
Adds a subscription for the authenticated user's channel
Authorization
To use this building block you will have to grant access to at least one of the following scopes:
- Manage your YouTube account
- See, edit, and permanently delete your YouTube videos, ratings, comments and captions
- View and manage your assets and associated content on YouTube
Input
This building block consumes 65 input parameters
Name | Format | Description |
---|---|---|
part Required |
STRING |
The part parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include |
contentDetails |
OBJECT |
Details about the content to witch a subscription refers |
contentDetails.activityType |
ENUMERATION |
The type of activity this subscription is for (only uploads, everything) |
contentDetails.newItemCount |
INTEGER |
The number of new items in the subscription since its content was last read |
contentDetails.totalItemCount |
INTEGER |
The approximate number of items that the subscription points to |
etag |
STRING |
Etag of this resource |
id |
STRING |
The ID that YouTube uses to uniquely identify the subscription |
kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "youtube#subscription" |
snippet |
OBJECT |
Basic details about a subscription, including title, description and thumbnails of the subscribed item |
snippet.channelId |
STRING |
The ID that YouTube uses to uniquely identify the subscriber's channel |
snippet.channelTitle |
STRING |
Channel title for the channel that the subscription belongs to |
snippet.description |
STRING |
The subscription's details |
snippet.publishedAt |
DATE_TIME |
The date and time that the subscription was created. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format |
snippet.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
snippet.resourceId.channelId |
STRING |
The ID that YouTube uses to uniquely identify the referred resource, if that resource is a channel. This property is only present if the resourceId.kind value is youtube#channel |
snippet.resourceId.kind |
STRING |
The type of the API resource |
snippet.resourceId.playlistId |
STRING |
The ID that YouTube uses to uniquely identify the referred resource, if that resource is a playlist. This property is only present if the resourceId.kind value is youtube#playlist |
snippet.resourceId.videoId |
STRING |
The ID that YouTube uses to uniquely identify the referred resource, if that resource is a video. This property is only present if the resourceId.kind value is youtube#video |
snippet.thumbnails |
OBJECT |
Internal representation of thumbnails for a YouTube resource |
snippet.thumbnails.default |
OBJECT |
A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.default.height |
INTEGER |
(Optional) Height of the thumbnail image |
snippet.thumbnails.default.url |
STRING |
The thumbnail image's URL |
snippet.thumbnails.default.width |
INTEGER |
(Optional) Width of the thumbnail image |
snippet.thumbnails.high |
OBJECT |
A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.high.height |
INTEGER |
(Optional) Height of the thumbnail image |
snippet.thumbnails.high.url |
STRING |
The thumbnail image's URL |
snippet.thumbnails.high.width |
INTEGER |
(Optional) Width of the thumbnail image |
snippet.thumbnails.maxres |
OBJECT |
A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.maxres.height |
INTEGER |
(Optional) Height of the thumbnail image |
snippet.thumbnails.maxres.url |
STRING |
The thumbnail image's URL |
snippet.thumbnails.maxres.width |
INTEGER |
(Optional) Width of the thumbnail image |
snippet.thumbnails.medium |
OBJECT |
A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.medium.height |
INTEGER |
(Optional) Height of the thumbnail image |
snippet.thumbnails.medium.url |
STRING |
The thumbnail image's URL |
snippet.thumbnails.medium.width |
INTEGER |
(Optional) Width of the thumbnail image |
snippet.thumbnails.standard |
OBJECT |
A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.standard.height |
INTEGER |
(Optional) Height of the thumbnail image |
snippet.thumbnails.standard.url |
STRING |
The thumbnail image's URL |
snippet.thumbnails.standard.width |
INTEGER |
(Optional) Width of the thumbnail image |
snippet.title |
STRING |
The subscription's title |
subscriberSnippet |
OBJECT |
Basic details about a subscription's subscriber including title, description, channel ID and thumbnails |
subscriberSnippet.channelId |
STRING |
The channel ID of the subscriber |
subscriberSnippet.description |
STRING |
The description of the subscriber |
subscriberSnippet.thumbnails |
OBJECT |
Internal representation of thumbnails for a YouTube resource |
subscriberSnippet.thumbnails.default |
OBJECT |
A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.default.height |
INTEGER |
(Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.default.url |
STRING |
The thumbnail image's URL |
subscriberSnippet.thumbnails.default.width |
INTEGER |
(Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.high |
OBJECT |
A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.high.height |
INTEGER |
(Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.high.url |
STRING |
The thumbnail image's URL |
subscriberSnippet.thumbnails.high.width |
INTEGER |
(Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.maxres |
OBJECT |
A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.maxres.height |
INTEGER |
(Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.maxres.url |
STRING |
The thumbnail image's URL |
subscriberSnippet.thumbnails.maxres.width |
INTEGER |
(Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.medium |
OBJECT |
A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.medium.height |
INTEGER |
(Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.medium.url |
STRING |
The thumbnail image's URL |
subscriberSnippet.thumbnails.medium.width |
INTEGER |
(Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.standard |
OBJECT |
A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.standard.height |
INTEGER |
(Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.standard.url |
STRING |
The thumbnail image's URL |
subscriberSnippet.thumbnails.standard.width |
INTEGER |
(Optional) Width of the thumbnail image |
subscriberSnippet.title |
STRING |
The title of the subscriber |
= Parameter name
= Format
part STRING Required The part parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include |
contentDetails OBJECT Details about the content to witch a subscription refers |
contentDetails.activityType ENUMERATION The type of activity this subscription is for (only uploads, everything) |
contentDetails.newItemCount INTEGER The number of new items in the subscription since its content was last read |
contentDetails.totalItemCount INTEGER The approximate number of items that the subscription points to |
etag STRING Etag of this resource |
id STRING The ID that YouTube uses to uniquely identify the subscription |
kind STRING Identifies what kind of resource this is. Value: the fixed string "youtube#subscription" |
snippet OBJECT Basic details about a subscription, including title, description and thumbnails of the subscribed item |
snippet.channelId STRING The ID that YouTube uses to uniquely identify the subscriber's channel |
snippet.channelTitle STRING Channel title for the channel that the subscription belongs to |
snippet.description STRING The subscription's details |
snippet.publishedAt DATE_TIME The date and time that the subscription was created. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format |
snippet.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
snippet.resourceId.channelId STRING The ID that YouTube uses to uniquely identify the referred resource, if that resource is a channel. This property is only present if the resourceId.kind value is youtube#channel |
snippet.resourceId.kind STRING The type of the API resource |
snippet.resourceId.playlistId STRING The ID that YouTube uses to uniquely identify the referred resource, if that resource is a playlist. This property is only present if the resourceId.kind value is youtube#playlist |
snippet.resourceId.videoId STRING The ID that YouTube uses to uniquely identify the referred resource, if that resource is a video. This property is only present if the resourceId.kind value is youtube#video |
snippet.thumbnails OBJECT Internal representation of thumbnails for a YouTube resource |
snippet.thumbnails.default OBJECT A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.default.height INTEGER (Optional) Height of the thumbnail image |
snippet.thumbnails.default.url STRING The thumbnail image's URL |
snippet.thumbnails.default.width INTEGER (Optional) Width of the thumbnail image |
snippet.thumbnails.high OBJECT A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.high.height INTEGER (Optional) Height of the thumbnail image |
snippet.thumbnails.high.url STRING The thumbnail image's URL |
snippet.thumbnails.high.width INTEGER (Optional) Width of the thumbnail image |
snippet.thumbnails.maxres OBJECT A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.maxres.height INTEGER (Optional) Height of the thumbnail image |
snippet.thumbnails.maxres.url STRING The thumbnail image's URL |
snippet.thumbnails.maxres.width INTEGER (Optional) Width of the thumbnail image |
snippet.thumbnails.medium OBJECT A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.medium.height INTEGER (Optional) Height of the thumbnail image |
snippet.thumbnails.medium.url STRING The thumbnail image's URL |
snippet.thumbnails.medium.width INTEGER (Optional) Width of the thumbnail image |
snippet.thumbnails.standard OBJECT A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.standard.height INTEGER (Optional) Height of the thumbnail image |
snippet.thumbnails.standard.url STRING The thumbnail image's URL |
snippet.thumbnails.standard.width INTEGER (Optional) Width of the thumbnail image |
snippet.title STRING The subscription's title |
subscriberSnippet OBJECT Basic details about a subscription's subscriber including title, description, channel ID and thumbnails |
subscriberSnippet.channelId STRING The channel ID of the subscriber |
subscriberSnippet.description STRING The description of the subscriber |
subscriberSnippet.thumbnails OBJECT Internal representation of thumbnails for a YouTube resource |
subscriberSnippet.thumbnails.default OBJECT A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.default.height INTEGER (Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.default.url STRING The thumbnail image's URL |
subscriberSnippet.thumbnails.default.width INTEGER (Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.high OBJECT A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.high.height INTEGER (Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.high.url STRING The thumbnail image's URL |
subscriberSnippet.thumbnails.high.width INTEGER (Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.maxres OBJECT A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.maxres.height INTEGER (Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.maxres.url STRING The thumbnail image's URL |
subscriberSnippet.thumbnails.maxres.width INTEGER (Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.medium OBJECT A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.medium.height INTEGER (Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.medium.url STRING The thumbnail image's URL |
subscriberSnippet.thumbnails.medium.width INTEGER (Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.standard OBJECT A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.standard.height INTEGER (Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.standard.url STRING The thumbnail image's URL |
subscriberSnippet.thumbnails.standard.width INTEGER (Optional) Width of the thumbnail image |
subscriberSnippet.title STRING The title of the subscriber |
Output
This building block provides 64 output parameters
Name | Format | Description |
---|---|---|
contentDetails |
OBJECT |
Details about the content to witch a subscription refers |
contentDetails.activityType |
ENUMERATION |
The type of activity this subscription is for (only uploads, everything) |
contentDetails.newItemCount |
INTEGER |
The number of new items in the subscription since its content was last read |
contentDetails.totalItemCount |
INTEGER |
The approximate number of items that the subscription points to |
etag |
STRING |
Etag of this resource |
id |
STRING |
The ID that YouTube uses to uniquely identify the subscription |
kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "youtube#subscription" |
snippet |
OBJECT |
Basic details about a subscription, including title, description and thumbnails of the subscribed item |
snippet.channelId |
STRING |
The ID that YouTube uses to uniquely identify the subscriber's channel |
snippet.channelTitle |
STRING |
Channel title for the channel that the subscription belongs to |
snippet.description |
STRING |
The subscription's details |
snippet.publishedAt |
DATE_TIME |
The date and time that the subscription was created. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format |
snippet.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
snippet.resourceId.channelId |
STRING |
The ID that YouTube uses to uniquely identify the referred resource, if that resource is a channel. This property is only present if the resourceId.kind value is youtube#channel |
snippet.resourceId.kind |
STRING |
The type of the API resource |
snippet.resourceId.playlistId |
STRING |
The ID that YouTube uses to uniquely identify the referred resource, if that resource is a playlist. This property is only present if the resourceId.kind value is youtube#playlist |
snippet.resourceId.videoId |
STRING |
The ID that YouTube uses to uniquely identify the referred resource, if that resource is a video. This property is only present if the resourceId.kind value is youtube#video |
snippet.thumbnails |
OBJECT |
Internal representation of thumbnails for a YouTube resource |
snippet.thumbnails.default |
OBJECT |
A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.default.height |
INTEGER |
(Optional) Height of the thumbnail image |
snippet.thumbnails.default.url |
STRING |
The thumbnail image's URL |
snippet.thumbnails.default.width |
INTEGER |
(Optional) Width of the thumbnail image |
snippet.thumbnails.high |
OBJECT |
A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.high.height |
INTEGER |
(Optional) Height of the thumbnail image |
snippet.thumbnails.high.url |
STRING |
The thumbnail image's URL |
snippet.thumbnails.high.width |
INTEGER |
(Optional) Width of the thumbnail image |
snippet.thumbnails.maxres |
OBJECT |
A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.maxres.height |
INTEGER |
(Optional) Height of the thumbnail image |
snippet.thumbnails.maxres.url |
STRING |
The thumbnail image's URL |
snippet.thumbnails.maxres.width |
INTEGER |
(Optional) Width of the thumbnail image |
snippet.thumbnails.medium |
OBJECT |
A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.medium.height |
INTEGER |
(Optional) Height of the thumbnail image |
snippet.thumbnails.medium.url |
STRING |
The thumbnail image's URL |
snippet.thumbnails.medium.width |
INTEGER |
(Optional) Width of the thumbnail image |
snippet.thumbnails.standard |
OBJECT |
A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.standard.height |
INTEGER |
(Optional) Height of the thumbnail image |
snippet.thumbnails.standard.url |
STRING |
The thumbnail image's URL |
snippet.thumbnails.standard.width |
INTEGER |
(Optional) Width of the thumbnail image |
snippet.title |
STRING |
The subscription's title |
subscriberSnippet |
OBJECT |
Basic details about a subscription's subscriber including title, description, channel ID and thumbnails |
subscriberSnippet.channelId |
STRING |
The channel ID of the subscriber |
subscriberSnippet.description |
STRING |
The description of the subscriber |
subscriberSnippet.thumbnails |
OBJECT |
Internal representation of thumbnails for a YouTube resource |
subscriberSnippet.thumbnails.default |
OBJECT |
A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.default.height |
INTEGER |
(Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.default.url |
STRING |
The thumbnail image's URL |
subscriberSnippet.thumbnails.default.width |
INTEGER |
(Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.high |
OBJECT |
A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.high.height |
INTEGER |
(Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.high.url |
STRING |
The thumbnail image's URL |
subscriberSnippet.thumbnails.high.width |
INTEGER |
(Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.maxres |
OBJECT |
A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.maxres.height |
INTEGER |
(Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.maxres.url |
STRING |
The thumbnail image's URL |
subscriberSnippet.thumbnails.maxres.width |
INTEGER |
(Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.medium |
OBJECT |
A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.medium.height |
INTEGER |
(Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.medium.url |
STRING |
The thumbnail image's URL |
subscriberSnippet.thumbnails.medium.width |
INTEGER |
(Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.standard |
OBJECT |
A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.standard.height |
INTEGER |
(Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.standard.url |
STRING |
The thumbnail image's URL |
subscriberSnippet.thumbnails.standard.width |
INTEGER |
(Optional) Width of the thumbnail image |
subscriberSnippet.title |
STRING |
The title of the subscriber |
= Parameter name
= Format
contentDetails OBJECT Details about the content to witch a subscription refers |
contentDetails.activityType ENUMERATION The type of activity this subscription is for (only uploads, everything) |
contentDetails.newItemCount INTEGER The number of new items in the subscription since its content was last read |
contentDetails.totalItemCount INTEGER The approximate number of items that the subscription points to |
etag STRING Etag of this resource |
id STRING The ID that YouTube uses to uniquely identify the subscription |
kind STRING Identifies what kind of resource this is. Value: the fixed string "youtube#subscription" |
snippet OBJECT Basic details about a subscription, including title, description and thumbnails of the subscribed item |
snippet.channelId STRING The ID that YouTube uses to uniquely identify the subscriber's channel |
snippet.channelTitle STRING Channel title for the channel that the subscription belongs to |
snippet.description STRING The subscription's details |
snippet.publishedAt DATE_TIME The date and time that the subscription was created. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format |
snippet.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
snippet.resourceId.channelId STRING The ID that YouTube uses to uniquely identify the referred resource, if that resource is a channel. This property is only present if the resourceId.kind value is youtube#channel |
snippet.resourceId.kind STRING The type of the API resource |
snippet.resourceId.playlistId STRING The ID that YouTube uses to uniquely identify the referred resource, if that resource is a playlist. This property is only present if the resourceId.kind value is youtube#playlist |
snippet.resourceId.videoId STRING The ID that YouTube uses to uniquely identify the referred resource, if that resource is a video. This property is only present if the resourceId.kind value is youtube#video |
snippet.thumbnails OBJECT Internal representation of thumbnails for a YouTube resource |
snippet.thumbnails.default OBJECT A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.default.height INTEGER (Optional) Height of the thumbnail image |
snippet.thumbnails.default.url STRING The thumbnail image's URL |
snippet.thumbnails.default.width INTEGER (Optional) Width of the thumbnail image |
snippet.thumbnails.high OBJECT A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.high.height INTEGER (Optional) Height of the thumbnail image |
snippet.thumbnails.high.url STRING The thumbnail image's URL |
snippet.thumbnails.high.width INTEGER (Optional) Width of the thumbnail image |
snippet.thumbnails.maxres OBJECT A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.maxres.height INTEGER (Optional) Height of the thumbnail image |
snippet.thumbnails.maxres.url STRING The thumbnail image's URL |
snippet.thumbnails.maxres.width INTEGER (Optional) Width of the thumbnail image |
snippet.thumbnails.medium OBJECT A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.medium.height INTEGER (Optional) Height of the thumbnail image |
snippet.thumbnails.medium.url STRING The thumbnail image's URL |
snippet.thumbnails.medium.width INTEGER (Optional) Width of the thumbnail image |
snippet.thumbnails.standard OBJECT A thumbnail is an image representing a YouTube resource |
snippet.thumbnails.standard.height INTEGER (Optional) Height of the thumbnail image |
snippet.thumbnails.standard.url STRING The thumbnail image's URL |
snippet.thumbnails.standard.width INTEGER (Optional) Width of the thumbnail image |
snippet.title STRING The subscription's title |
subscriberSnippet OBJECT Basic details about a subscription's subscriber including title, description, channel ID and thumbnails |
subscriberSnippet.channelId STRING The channel ID of the subscriber |
subscriberSnippet.description STRING The description of the subscriber |
subscriberSnippet.thumbnails OBJECT Internal representation of thumbnails for a YouTube resource |
subscriberSnippet.thumbnails.default OBJECT A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.default.height INTEGER (Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.default.url STRING The thumbnail image's URL |
subscriberSnippet.thumbnails.default.width INTEGER (Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.high OBJECT A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.high.height INTEGER (Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.high.url STRING The thumbnail image's URL |
subscriberSnippet.thumbnails.high.width INTEGER (Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.maxres OBJECT A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.maxres.height INTEGER (Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.maxres.url STRING The thumbnail image's URL |
subscriberSnippet.thumbnails.maxres.width INTEGER (Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.medium OBJECT A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.medium.height INTEGER (Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.medium.url STRING The thumbnail image's URL |
subscriberSnippet.thumbnails.medium.width INTEGER (Optional) Width of the thumbnail image |
subscriberSnippet.thumbnails.standard OBJECT A thumbnail is an image representing a YouTube resource |
subscriberSnippet.thumbnails.standard.height INTEGER (Optional) Height of the thumbnail image |
subscriberSnippet.thumbnails.standard.url STRING The thumbnail image's URL |
subscriberSnippet.thumbnails.standard.width INTEGER (Optional) Width of the thumbnail image |
subscriberSnippet.title STRING The title of the subscriber |