Insert
|
|||||
|
|
||||
Posts a bulletin for a specific channel. (The user submitting the request must be authorized to act on the channel's behalf.)
Note: Even though an activity resource can contain information about actions like a user rating a video or marking a video as a favorite, you need to use other API methods to generate those activity resources. For example, you would use the API's videos.rate() method to rate a video and the playlistItems.insert() method to mark a video as a favorite
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
Input
This building block consumes 113 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 of an activity: the video that was shared, the channel that was subscribed to, etc |
contentDetails.bulletin |
OBJECT |
Details about a channel bulletin post |
contentDetails.bulletin.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.bulletin.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 |
contentDetails.bulletin.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.bulletin.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 |
contentDetails.bulletin.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 |
contentDetails.channelItem |
OBJECT |
Details about a resource which was added to a channel |
contentDetails.channelItem.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.channelItem.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 |
contentDetails.channelItem.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.channelItem.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 |
contentDetails.channelItem.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 |
contentDetails.comment |
OBJECT |
Information about a resource that received a comment |
contentDetails.comment.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.comment.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 |
contentDetails.comment.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.comment.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 |
contentDetails.comment.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 |
contentDetails.favorite |
OBJECT |
Information about a video that was marked as a favorite video |
contentDetails.favorite.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.favorite.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 |
contentDetails.favorite.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.favorite.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 |
contentDetails.favorite.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 |
contentDetails.like |
OBJECT |
Information about a resource that received a positive (like) rating |
contentDetails.like.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.like.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 |
contentDetails.like.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.like.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 |
contentDetails.like.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 |
contentDetails.playlistItem |
OBJECT |
Information about a new playlist item |
contentDetails.playlistItem.playlistId |
STRING |
The value that YouTube uses to uniquely identify the playlist |
contentDetails.playlistItem.playlistItemId |
STRING |
ID of the item within the playlist |
contentDetails.playlistItem.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.playlistItem.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 |
contentDetails.playlistItem.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.playlistItem.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 |
contentDetails.playlistItem.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 |
contentDetails.promotedItem |
OBJECT |
Details about a resource which is being promoted |
contentDetails.promotedItem.adTag |
STRING |
The URL the client should fetch to request a promoted item |
contentDetails.promotedItem.clickTrackingUrl |
STRING |
The URL the client should ping to indicate that the user clicked through on this promoted item |
contentDetails.promotedItem.creativeViewUrl |
STRING |
The URL the client should ping to indicate that the user was shown this promoted item |
contentDetails.promotedItem.ctaType |
ENUMERATION |
The type of call-to-action, a message to the user indicating action that can be taken |
contentDetails.promotedItem.customCtaButtonText |
STRING |
The custom call-to-action button text. If specified, it will override the default button text for the cta_type |
contentDetails.promotedItem.descriptionText |
STRING |
The text description to accompany the promoted item |
contentDetails.promotedItem.destinationUrl |
STRING |
The URL the client should direct the user to, if the user chooses to visit the advertiser's website |
contentDetails.promotedItem.forecastingUrl[] |
STRING |
|
contentDetails.promotedItem.impressionUrl[] |
STRING |
|
contentDetails.promotedItem.videoId |
STRING |
The ID that YouTube uses to uniquely identify the promoted video |
contentDetails.recommendation |
OBJECT |
Information that identifies the recommended resource |
contentDetails.recommendation.reason |
ENUMERATION |
The reason that the resource is recommended to the user |
contentDetails.recommendation.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.recommendation.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 |
contentDetails.recommendation.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.recommendation.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 |
contentDetails.recommendation.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 |
contentDetails.recommendation.seedResourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.recommendation.seedResourceId.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 |
contentDetails.recommendation.seedResourceId.kind |
STRING |
The type of the API resource |
contentDetails.recommendation.seedResourceId.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 |
contentDetails.recommendation.seedResourceId.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 |
contentDetails.social |
OBJECT |
Details about a social network post |
contentDetails.social.author |
STRING |
The author of the social network post |
contentDetails.social.imageUrl |
STRING |
An image of the post's author |
contentDetails.social.referenceUrl |
STRING |
The URL of the social network post |
contentDetails.social.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.social.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 |
contentDetails.social.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.social.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 |
contentDetails.social.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 |
contentDetails.social.type |
ENUMERATION |
The name of the social network |
contentDetails.subscription |
OBJECT |
Information about a channel that a user subscribed to |
contentDetails.subscription.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.subscription.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 |
contentDetails.subscription.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.subscription.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 |
contentDetails.subscription.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 |
contentDetails.upload |
OBJECT |
Information about the uploaded video |
contentDetails.upload.videoId |
STRING |
The ID that YouTube uses to uniquely identify the uploaded video |
etag |
STRING |
Etag of this resource |
id |
STRING |
The ID that YouTube uses to uniquely identify the activity |
kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "youtube#activity" |
snippet |
OBJECT |
Basic details about an activity, including title, description, thumbnails, activity type and group |
snippet.channelId |
STRING |
The ID that YouTube uses to uniquely identify the channel associated with the activity |
snippet.channelTitle |
STRING |
Channel title for the channel responsible for this activity |
snippet.description |
STRING |
The description of the resource primarily associated with the activity |
snippet.groupId |
STRING |
The group ID associated with the activity. A group ID identifies user events that are associated with the same user and resource. For example, if a user rates a video and marks the same video as a favorite, the entries for those events would have the same group ID in the user's activity feed. In your user interface, you can avoid repetition by grouping events with the same groupId value |
snippet.publishedAt |
DATE_TIME |
The date and time that the video was uploaded. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format |
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 title of the resource primarily associated with the activity |
snippet.type |
ENUMERATION |
The type of activity that the resource describes |
= 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 of an activity: the video that was shared, the channel that was subscribed to, etc |
|
contentDetails.bulletin OBJECT Details about a channel bulletin post |
|
contentDetails.bulletin.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.bulletin.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 |
|
contentDetails.bulletin.resourceId.kind STRING The type of the API resource |
|
contentDetails.bulletin.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 |
|
contentDetails.bulletin.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 |
|
contentDetails.channelItem OBJECT Details about a resource which was added to a channel |
|
contentDetails.channelItem.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.channelItem.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 |
|
contentDetails.channelItem.resourceId.kind STRING The type of the API resource |
|
contentDetails.channelItem.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 |
|
contentDetails.channelItem.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 |
|
contentDetails.comment OBJECT Information about a resource that received a comment |
|
contentDetails.comment.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.comment.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 |
|
contentDetails.comment.resourceId.kind STRING The type of the API resource |
|
contentDetails.comment.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 |
|
contentDetails.comment.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 |
|
contentDetails.favorite OBJECT Information about a video that was marked as a favorite video |
|
contentDetails.favorite.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.favorite.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 |
|
contentDetails.favorite.resourceId.kind STRING The type of the API resource |
|
contentDetails.favorite.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 |
|
contentDetails.favorite.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 |
|
contentDetails.like OBJECT Information about a resource that received a positive (like) rating |
|
contentDetails.like.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.like.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 |
|
contentDetails.like.resourceId.kind STRING The type of the API resource |
|
contentDetails.like.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 |
|
contentDetails.like.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 |
|
contentDetails.playlistItem OBJECT Information about a new playlist item |
|
contentDetails.playlistItem.playlistId STRING The value that YouTube uses to uniquely identify the playlist |
|
contentDetails.playlistItem.playlistItemId STRING ID of the item within the playlist |
|
contentDetails.playlistItem.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.playlistItem.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 |
|
contentDetails.playlistItem.resourceId.kind STRING The type of the API resource |
|
contentDetails.playlistItem.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 |
|
contentDetails.playlistItem.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 |
|
contentDetails.promotedItem OBJECT Details about a resource which is being promoted |
|
contentDetails.promotedItem.adTag STRING The URL the client should fetch to request a promoted item |
|
contentDetails.promotedItem.clickTrackingUrl STRING The URL the client should ping to indicate that the user clicked through on this promoted item |
|
contentDetails.promotedItem.creativeViewUrl STRING The URL the client should ping to indicate that the user was shown this promoted item |
|
contentDetails.promotedItem.ctaType ENUMERATION The type of call-to-action, a message to the user indicating action that can be taken |
|
contentDetails.promotedItem.customCtaButtonText STRING The custom call-to-action button text. If specified, it will override the default button text for the cta_type |
|
contentDetails.promotedItem.descriptionText STRING The text description to accompany the promoted item |
|
contentDetails.promotedItem.destinationUrl STRING The URL the client should direct the user to, if the user chooses to visit the advertiser's website |
|
contentDetails.promotedItem.forecastingUrl[] STRING |
|
contentDetails.promotedItem.impressionUrl[] STRING |
|
contentDetails.promotedItem.videoId STRING The ID that YouTube uses to uniquely identify the promoted video |
|
contentDetails.recommendation OBJECT Information that identifies the recommended resource |
|
contentDetails.recommendation.reason ENUMERATION The reason that the resource is recommended to the user |
|
contentDetails.recommendation.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.recommendation.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 |
|
contentDetails.recommendation.resourceId.kind STRING The type of the API resource |
|
contentDetails.recommendation.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 |
|
contentDetails.recommendation.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 |
|
contentDetails.recommendation.seedResourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.recommendation.seedResourceId.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 |
|
contentDetails.recommendation.seedResourceId.kind STRING The type of the API resource |
|
contentDetails.recommendation.seedResourceId.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 |
|
contentDetails.recommendation.seedResourceId.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 |
|
contentDetails.social OBJECT Details about a social network post |
|
contentDetails.social.author STRING The author of the social network post |
|
contentDetails.social.imageUrl STRING An image of the post's author |
|
contentDetails.social.referenceUrl STRING The URL of the social network post |
|
contentDetails.social.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.social.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 |
|
contentDetails.social.resourceId.kind STRING The type of the API resource |
|
contentDetails.social.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 |
|
contentDetails.social.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 |
|
contentDetails.social.type ENUMERATION The name of the social network |
|
contentDetails.subscription OBJECT Information about a channel that a user subscribed to |
|
contentDetails.subscription.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.subscription.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 |
|
contentDetails.subscription.resourceId.kind STRING The type of the API resource |
|
contentDetails.subscription.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 |
|
contentDetails.subscription.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 |
|
contentDetails.upload OBJECT Information about the uploaded video |
|
contentDetails.upload.videoId STRING The ID that YouTube uses to uniquely identify the uploaded video |
|
etag STRING Etag of this resource |
|
id STRING The ID that YouTube uses to uniquely identify the activity |
|
kind STRING Identifies what kind of resource this is. Value: the fixed string "youtube#activity" |
|
snippet OBJECT Basic details about an activity, including title, description, thumbnails, activity type and group |
|
snippet.channelId STRING The ID that YouTube uses to uniquely identify the channel associated with the activity |
|
snippet.channelTitle STRING Channel title for the channel responsible for this activity |
|
snippet.description STRING The description of the resource primarily associated with the activity |
|
snippet.groupId STRING The group ID associated with the activity. A group ID identifies user events that are associated with the same user and resource. For example, if a user rates a video and marks the same video as a favorite, the entries for those events would have the same group ID in the user's activity feed. In your user interface, you can avoid repetition by grouping events with the same groupId value |
|
snippet.publishedAt DATE_TIME The date and time that the video was uploaded. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format |
|
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 title of the resource primarily associated with the activity |
|
snippet.type ENUMERATION The type of activity that the resource describes |
Output
This building block provides 112 output parameters
| Name | Format | Description |
|---|---|---|
contentDetails |
OBJECT |
Details about the content of an activity: the video that was shared, the channel that was subscribed to, etc |
contentDetails.bulletin |
OBJECT |
Details about a channel bulletin post |
contentDetails.bulletin.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.bulletin.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 |
contentDetails.bulletin.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.bulletin.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 |
contentDetails.bulletin.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 |
contentDetails.channelItem |
OBJECT |
Details about a resource which was added to a channel |
contentDetails.channelItem.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.channelItem.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 |
contentDetails.channelItem.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.channelItem.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 |
contentDetails.channelItem.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 |
contentDetails.comment |
OBJECT |
Information about a resource that received a comment |
contentDetails.comment.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.comment.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 |
contentDetails.comment.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.comment.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 |
contentDetails.comment.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 |
contentDetails.favorite |
OBJECT |
Information about a video that was marked as a favorite video |
contentDetails.favorite.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.favorite.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 |
contentDetails.favorite.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.favorite.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 |
contentDetails.favorite.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 |
contentDetails.like |
OBJECT |
Information about a resource that received a positive (like) rating |
contentDetails.like.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.like.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 |
contentDetails.like.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.like.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 |
contentDetails.like.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 |
contentDetails.playlistItem |
OBJECT |
Information about a new playlist item |
contentDetails.playlistItem.playlistId |
STRING |
The value that YouTube uses to uniquely identify the playlist |
contentDetails.playlistItem.playlistItemId |
STRING |
ID of the item within the playlist |
contentDetails.playlistItem.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.playlistItem.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 |
contentDetails.playlistItem.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.playlistItem.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 |
contentDetails.playlistItem.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 |
contentDetails.promotedItem |
OBJECT |
Details about a resource which is being promoted |
contentDetails.promotedItem.adTag |
STRING |
The URL the client should fetch to request a promoted item |
contentDetails.promotedItem.clickTrackingUrl |
STRING |
The URL the client should ping to indicate that the user clicked through on this promoted item |
contentDetails.promotedItem.creativeViewUrl |
STRING |
The URL the client should ping to indicate that the user was shown this promoted item |
contentDetails.promotedItem.ctaType |
ENUMERATION |
The type of call-to-action, a message to the user indicating action that can be taken |
contentDetails.promotedItem.customCtaButtonText |
STRING |
The custom call-to-action button text. If specified, it will override the default button text for the cta_type |
contentDetails.promotedItem.descriptionText |
STRING |
The text description to accompany the promoted item |
contentDetails.promotedItem.destinationUrl |
STRING |
The URL the client should direct the user to, if the user chooses to visit the advertiser's website |
contentDetails.promotedItem.forecastingUrl[] |
STRING |
|
contentDetails.promotedItem.impressionUrl[] |
STRING |
|
contentDetails.promotedItem.videoId |
STRING |
The ID that YouTube uses to uniquely identify the promoted video |
contentDetails.recommendation |
OBJECT |
Information that identifies the recommended resource |
contentDetails.recommendation.reason |
ENUMERATION |
The reason that the resource is recommended to the user |
contentDetails.recommendation.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.recommendation.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 |
contentDetails.recommendation.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.recommendation.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 |
contentDetails.recommendation.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 |
contentDetails.recommendation.seedResourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.recommendation.seedResourceId.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 |
contentDetails.recommendation.seedResourceId.kind |
STRING |
The type of the API resource |
contentDetails.recommendation.seedResourceId.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 |
contentDetails.recommendation.seedResourceId.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 |
contentDetails.social |
OBJECT |
Details about a social network post |
contentDetails.social.author |
STRING |
The author of the social network post |
contentDetails.social.imageUrl |
STRING |
An image of the post's author |
contentDetails.social.referenceUrl |
STRING |
The URL of the social network post |
contentDetails.social.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.social.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 |
contentDetails.social.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.social.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 |
contentDetails.social.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 |
contentDetails.social.type |
ENUMERATION |
The name of the social network |
contentDetails.subscription |
OBJECT |
Information about a channel that a user subscribed to |
contentDetails.subscription.resourceId |
OBJECT |
A resource id is a generic reference that points to another YouTube resource |
contentDetails.subscription.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 |
contentDetails.subscription.resourceId.kind |
STRING |
The type of the API resource |
contentDetails.subscription.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 |
contentDetails.subscription.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 |
contentDetails.upload |
OBJECT |
Information about the uploaded video |
contentDetails.upload.videoId |
STRING |
The ID that YouTube uses to uniquely identify the uploaded video |
etag |
STRING |
Etag of this resource |
id |
STRING |
The ID that YouTube uses to uniquely identify the activity |
kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "youtube#activity" |
snippet |
OBJECT |
Basic details about an activity, including title, description, thumbnails, activity type and group |
snippet.channelId |
STRING |
The ID that YouTube uses to uniquely identify the channel associated with the activity |
snippet.channelTitle |
STRING |
Channel title for the channel responsible for this activity |
snippet.description |
STRING |
The description of the resource primarily associated with the activity |
snippet.groupId |
STRING |
The group ID associated with the activity. A group ID identifies user events that are associated with the same user and resource. For example, if a user rates a video and marks the same video as a favorite, the entries for those events would have the same group ID in the user's activity feed. In your user interface, you can avoid repetition by grouping events with the same groupId value |
snippet.publishedAt |
DATE_TIME |
The date and time that the video was uploaded. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format |
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 title of the resource primarily associated with the activity |
snippet.type |
ENUMERATION |
The type of activity that the resource describes |
= Parameter name
= Format
|
contentDetails OBJECT Details about the content of an activity: the video that was shared, the channel that was subscribed to, etc |
|
contentDetails.bulletin OBJECT Details about a channel bulletin post |
|
contentDetails.bulletin.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.bulletin.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 |
|
contentDetails.bulletin.resourceId.kind STRING The type of the API resource |
|
contentDetails.bulletin.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 |
|
contentDetails.bulletin.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 |
|
contentDetails.channelItem OBJECT Details about a resource which was added to a channel |
|
contentDetails.channelItem.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.channelItem.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 |
|
contentDetails.channelItem.resourceId.kind STRING The type of the API resource |
|
contentDetails.channelItem.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 |
|
contentDetails.channelItem.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 |
|
contentDetails.comment OBJECT Information about a resource that received a comment |
|
contentDetails.comment.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.comment.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 |
|
contentDetails.comment.resourceId.kind STRING The type of the API resource |
|
contentDetails.comment.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 |
|
contentDetails.comment.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 |
|
contentDetails.favorite OBJECT Information about a video that was marked as a favorite video |
|
contentDetails.favorite.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.favorite.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 |
|
contentDetails.favorite.resourceId.kind STRING The type of the API resource |
|
contentDetails.favorite.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 |
|
contentDetails.favorite.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 |
|
contentDetails.like OBJECT Information about a resource that received a positive (like) rating |
|
contentDetails.like.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.like.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 |
|
contentDetails.like.resourceId.kind STRING The type of the API resource |
|
contentDetails.like.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 |
|
contentDetails.like.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 |
|
contentDetails.playlistItem OBJECT Information about a new playlist item |
|
contentDetails.playlistItem.playlistId STRING The value that YouTube uses to uniquely identify the playlist |
|
contentDetails.playlistItem.playlistItemId STRING ID of the item within the playlist |
|
contentDetails.playlistItem.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.playlistItem.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 |
|
contentDetails.playlistItem.resourceId.kind STRING The type of the API resource |
|
contentDetails.playlistItem.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 |
|
contentDetails.playlistItem.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 |
|
contentDetails.promotedItem OBJECT Details about a resource which is being promoted |
|
contentDetails.promotedItem.adTag STRING The URL the client should fetch to request a promoted item |
|
contentDetails.promotedItem.clickTrackingUrl STRING The URL the client should ping to indicate that the user clicked through on this promoted item |
|
contentDetails.promotedItem.creativeViewUrl STRING The URL the client should ping to indicate that the user was shown this promoted item |
|
contentDetails.promotedItem.ctaType ENUMERATION The type of call-to-action, a message to the user indicating action that can be taken |
|
contentDetails.promotedItem.customCtaButtonText STRING The custom call-to-action button text. If specified, it will override the default button text for the cta_type |
|
contentDetails.promotedItem.descriptionText STRING The text description to accompany the promoted item |
|
contentDetails.promotedItem.destinationUrl STRING The URL the client should direct the user to, if the user chooses to visit the advertiser's website |
|
contentDetails.promotedItem.forecastingUrl[] STRING |
|
contentDetails.promotedItem.impressionUrl[] STRING |
|
contentDetails.promotedItem.videoId STRING The ID that YouTube uses to uniquely identify the promoted video |
|
contentDetails.recommendation OBJECT Information that identifies the recommended resource |
|
contentDetails.recommendation.reason ENUMERATION The reason that the resource is recommended to the user |
|
contentDetails.recommendation.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.recommendation.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 |
|
contentDetails.recommendation.resourceId.kind STRING The type of the API resource |
|
contentDetails.recommendation.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 |
|
contentDetails.recommendation.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 |
|
contentDetails.recommendation.seedResourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.recommendation.seedResourceId.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 |
|
contentDetails.recommendation.seedResourceId.kind STRING The type of the API resource |
|
contentDetails.recommendation.seedResourceId.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 |
|
contentDetails.recommendation.seedResourceId.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 |
|
contentDetails.social OBJECT Details about a social network post |
|
contentDetails.social.author STRING The author of the social network post |
|
contentDetails.social.imageUrl STRING An image of the post's author |
|
contentDetails.social.referenceUrl STRING The URL of the social network post |
|
contentDetails.social.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.social.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 |
|
contentDetails.social.resourceId.kind STRING The type of the API resource |
|
contentDetails.social.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 |
|
contentDetails.social.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 |
|
contentDetails.social.type ENUMERATION The name of the social network |
|
contentDetails.subscription OBJECT Information about a channel that a user subscribed to |
|
contentDetails.subscription.resourceId OBJECT A resource id is a generic reference that points to another YouTube resource |
|
contentDetails.subscription.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 |
|
contentDetails.subscription.resourceId.kind STRING The type of the API resource |
|
contentDetails.subscription.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 |
|
contentDetails.subscription.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 |
|
contentDetails.upload OBJECT Information about the uploaded video |
|
contentDetails.upload.videoId STRING The ID that YouTube uses to uniquely identify the uploaded video |
|
etag STRING Etag of this resource |
|
id STRING The ID that YouTube uses to uniquely identify the activity |
|
kind STRING Identifies what kind of resource this is. Value: the fixed string "youtube#activity" |
|
snippet OBJECT Basic details about an activity, including title, description, thumbnails, activity type and group |
|
snippet.channelId STRING The ID that YouTube uses to uniquely identify the channel associated with the activity |
|
snippet.channelTitle STRING Channel title for the channel responsible for this activity |
|
snippet.description STRING The description of the resource primarily associated with the activity |
|
snippet.groupId STRING The group ID associated with the activity. A group ID identifies user events that are associated with the same user and resource. For example, if a user rates a video and marks the same video as a favorite, the entries for those events would have the same group ID in the user's activity feed. In your user interface, you can avoid repetition by grouping events with the same groupId value |
|
snippet.publishedAt DATE_TIME The date and time that the video was uploaded. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format |
|
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 title of the resource primarily associated with the activity |
|
snippet.type ENUMERATION The type of activity that the resource describes |