Insert

Adds a subscription for the authenticated user's channel

65 variables
64 variables

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

  = 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

  = 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