Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 4d50cd6883f37e19a26fabe3af6a75d407146520 / . / docs / dyn / youtube_v3.activities.html
blob: d2744cb92e21a541e79eba918cf5ce41f5cadea2 [file] [log] [blame]
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]1<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]75<h1><a href="youtube_v3.html">YouTube Data API</a> . <a href="youtube_v3.activities.html">activities</a></h1>
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]76<h2>Instance Methods</h2>
77<p class="toc_element">
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]78 <code><a href="#insert">insert(part=None, body)</a></code></p>
79<p class="firstline">Posts a bulletin for a specific channel. (The user submitting the request must be authorized to act on the channel's behalf.)</p>
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]80<p class="toc_element">
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]81 <code><a href="#list">list(part=None, pageToken=None, publishedBefore=None, channelId=None, mine=None, maxResults=None, regionCode=None, home=None, publishedAfter=None)</a></code></p>
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]82<p class="firstline">Returns a list of channel activity events that match the request criteria. For example, you can retrieve events associated with a particular channel, events associated with the user's subscriptions and Google+ friends, or the YouTube home page feed, which is customized for each user.</p>
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]83<p class="toc_element">
84 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
85<p class="firstline">Retrieves the next page of results.</p>
86<h3>Method Details</h3>
87<div class="method">
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]88 <code class="details" id="insert">insert(part=None, body)</code>
89 <pre>Posts a bulletin for a specific channel. (The user submitting the request must be authorized to act on the channel's behalf.)
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]90
91Args:
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]92 part: 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.
93
94The part names that you can include in the parameter value are snippet and contentDetails. (required)
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]95 body: object, The request body. (required)
96 The object takes the form of:
97
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]98{ # An activity resource contains information about an action that a particular channel, or user, has taken on YouTube.The actions reported in activity feeds include rating a video, sharing a video, marking a video as a favorite, commenting on a video, uploading a video, and so forth. Each activity resource identifies the type of action, the channel associated with the action, and the resource(s) associated with the action, such as the video that was rated or uploaded.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]99 "snippet": { # Basic details about an activity, including title, description, thumbnails, activity type and group. # The snippet object contains basic details about the activity, including the activity's type and group ID.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]100 "thumbnails": { # Internal representation of thumbnails for a YouTube resource. # A map of thumbnail images associated with the resource that is primarily associated with the activity. For each object in the map, the key is the name of the thumbnail image, and the value is an object that contains other information about the thumbnail.
101 "default": { # A thumbnail is an image representing a YouTube resource. # The default image for this resource.
102 "url": "A String", # The thumbnail image's URL.
103 "width": 42, # (Optional) Width of the thumbnail image.
104 "height": 42, # (Optional) Height of the thumbnail image.
105 },
106 "high": { # A thumbnail is an image representing a YouTube resource. # The high quality image for this resource.
107 "url": "A String", # The thumbnail image's URL.
108 "width": 42, # (Optional) Width of the thumbnail image.
109 "height": 42, # (Optional) Height of the thumbnail image.
110 },
111 "medium": { # A thumbnail is an image representing a YouTube resource. # The medium quality image for this resource.
112 "url": "A String", # The thumbnail image's URL.
113 "width": 42, # (Optional) Width of the thumbnail image.
114 "height": 42, # (Optional) Height of the thumbnail image.
115 },
116 "maxres": { # A thumbnail is an image representing a YouTube resource. # The maximum resolution quality image for this resource.
117 "url": "A String", # The thumbnail image's URL.
118 "width": 42, # (Optional) Width of the thumbnail image.
119 "height": 42, # (Optional) Height of the thumbnail image.
120 },
121 "standard": { # A thumbnail is an image representing a YouTube resource. # The standard quality image for this resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]122 "url": "A String", # The thumbnail image's URL.
Joe Gregorio41be8e82013-03-07 10:31:47 -0500[diff] [blame]123 "width": 42, # (Optional) Width of the thumbnail image.
124 "height": 42, # (Optional) Height of the thumbnail image.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]125 },
126 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]127 "title": "A String", # The title of the resource primarily associated with the activity.
128 "channelId": "A String", # The ID that YouTube uses to uniquely identify the channel associated with the activity.
Joe Gregorio41be8e82013-03-07 10:31:47 -0500[diff] [blame]129 "publishedAt": "A String", # The date and time that the video was uploaded. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
130 "channelTitle": "A String", # Channel title for the channel responsible for this activity
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]131 "type": "A String", # The type of activity that the resource describes.
132 "groupId": "A 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.
133 "description": "A String", # The description of the resource primarily associated with the activity.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]134 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]135 "contentDetails": { # Details about the content of an activity: the video that was shared, the channel that was subscribed to, etc. # The contentDetails object contains information about the content associated with the activity. For example, if the snippet.type value is videoRated, then the contentDetails object's content identifies the rated video.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]136 "comment": { # Information about a resource that received a comment. # The comment object contains information about a resource that received a comment. This property is only present if the snippet.type is comment.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]137 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource associated with the comment.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]138 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]139 "channelId": "A 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.
140 "playlistId": "A 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.
141 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]142 },
143 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]144 "playlistItem": { # Information about a new playlist item. # The playlistItem object contains information about a new playlist item. This property is only present if the snippet.type is playlistItem.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]145 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information about the resource that was added to the playlist.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]146 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]147 "channelId": "A 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.
148 "playlistId": "A 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.
149 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]150 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]151 "playlistId": "A String", # The value that YouTube uses to uniquely identify the playlist.
152 "playlistItemId": "A String", # ID of the item within the playlist.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]153 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]154 "like": { # Information about a resource that received a positive (like) rating. # The like object contains information about a resource that received a positive (like) rating. This property is only present if the snippet.type is like.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]155 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the rated resource.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]156 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]157 "channelId": "A 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.
158 "playlistId": "A 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.
159 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]160 },
161 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]162 "promotedItem": { # Details about a resource which is being promoted. # The promotedItem object contains details about a resource which is being promoted. This property is only present if the snippet.type is promotedItem.
163 "ctaType": "A String", # The type of call-to-action, a message to the user indicating action that can be taken.
164 "adTag": "A String", # The URL the client should fetch to request a promoted item.
165 "destinationUrl": "A String", # The URL the client should direct the user to, if the user chooses to visit the advertiser's website.
166 "creativeViewUrl": "A String", # The URL the client should ping to indicate that the user was shown this promoted item.
167 "videoId": "A String", # The ID that YouTube uses to uniquely identify the promoted video.
168 "descriptionText": "A String", # The text description to accompany the promoted item.
169 "clickTrackingUrl": "A String", # The URL the client should ping to indicate that the user clicked through on this promoted item.
170 },
171 "social": { # Details about a social network post. # The social object contains details about a social network post. This property is only present if the snippet.type is social.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]172 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object encapsulates information that identifies the resource associated with a social network post.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]173 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]174 "channelId": "A 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.
175 "playlistId": "A 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.
176 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]177 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]178 "imageUrl": "A String", # An image of the post's author.
179 "type": "A String", # The name of the social network.
180 "referenceUrl": "A String", # The URL of the social network post.
181 "author": "A String", # The author of the social network post.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]182 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]183 "favorite": { # Information about a video that was marked as a favorite video. # The favorite object contains information about a video that was marked as a favorite video. This property is only present if the snippet.type is favorite.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]184 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource that was marked as a favorite.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]185 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]186 "channelId": "A 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.
187 "playlistId": "A 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.
188 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]189 },
190 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]191 "upload": { # Information about the uploaded video. # The upload object contains information about the uploaded video. This property is only present if the snippet.type is upload.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]192 "videoId": "A String", # The ID that YouTube uses to uniquely identify the uploaded video.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]193 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]194 "recommendation": { # Information that identifies the recommended resource. # The recommendation object contains information about a recommended resource. This property is only present if the snippet.type is recommendation.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]195 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the recommended resource.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]196 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]197 "channelId": "A 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.
198 "playlistId": "A 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.
199 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]200 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]201 "reason": "A String", # The reason that the resource is recommended to the user.
202 "seedResourceId": { # A resource id is a generic reference that points to another YouTube resource. # The seedResourceId object contains information about the resource that caused the recommendation.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]203 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]204 "channelId": "A 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.
205 "playlistId": "A 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.
206 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]207 },
208 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]209 "subscription": { # Information about a channel that a user subscribed to. # The subscription object contains information about a channel that a user subscribed to. This property is only present if the snippet.type is subscription.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]210 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource that the user subscribed to.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]211 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]212 "channelId": "A 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.
213 "playlistId": "A 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.
214 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]215 },
216 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]217 "bulletin": { # Details about a channel bulletin post. # The bulletin object contains details about a channel bulletin post. This object is only present if the snippet.type is bulletin.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]218 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource associated with a bulletin post.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]219 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]220 "channelId": "A 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.
221 "playlistId": "A 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.
222 "videoId": "A 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.
223 },
224 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]225 "channelItem": { # Details about a resource which was added to a channel. # The channelItem object contains details about a resource which was added to a channel. This property is only present if the snippet.type is channelItem.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]226 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource that was added to the channel.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]227 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]228 "channelId": "A 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.
229 "playlistId": "A 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.
230 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]231 },
232 },
233 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]234 "kind": "youtube#activity", # The kind, fixed to "youtube#activity".
235 "etag": "A String", # Etag of this resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]236 "id": "A String", # The ID that YouTube uses to uniquely identify the activity.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]237 }
238
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]239
240Returns:
241 An object of the form:
242
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]243 { # An activity resource contains information about an action that a particular channel, or user, has taken on YouTube.The actions reported in activity feeds include rating a video, sharing a video, marking a video as a favorite, commenting on a video, uploading a video, and so forth. Each activity resource identifies the type of action, the channel associated with the action, and the resource(s) associated with the action, such as the video that was rated or uploaded.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]244 "snippet": { # Basic details about an activity, including title, description, thumbnails, activity type and group. # The snippet object contains basic details about the activity, including the activity's type and group ID.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]245 "thumbnails": { # Internal representation of thumbnails for a YouTube resource. # A map of thumbnail images associated with the resource that is primarily associated with the activity. For each object in the map, the key is the name of the thumbnail image, and the value is an object that contains other information about the thumbnail.
246 "default": { # A thumbnail is an image representing a YouTube resource. # The default image for this resource.
247 "url": "A String", # The thumbnail image's URL.
248 "width": 42, # (Optional) Width of the thumbnail image.
249 "height": 42, # (Optional) Height of the thumbnail image.
250 },
251 "high": { # A thumbnail is an image representing a YouTube resource. # The high quality image for this resource.
252 "url": "A String", # The thumbnail image's URL.
253 "width": 42, # (Optional) Width of the thumbnail image.
254 "height": 42, # (Optional) Height of the thumbnail image.
255 },
256 "medium": { # A thumbnail is an image representing a YouTube resource. # The medium quality image for this resource.
257 "url": "A String", # The thumbnail image's URL.
258 "width": 42, # (Optional) Width of the thumbnail image.
259 "height": 42, # (Optional) Height of the thumbnail image.
260 },
261 "maxres": { # A thumbnail is an image representing a YouTube resource. # The maximum resolution quality image for this resource.
262 "url": "A String", # The thumbnail image's URL.
263 "width": 42, # (Optional) Width of the thumbnail image.
264 "height": 42, # (Optional) Height of the thumbnail image.
265 },
266 "standard": { # A thumbnail is an image representing a YouTube resource. # The standard quality image for this resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]267 "url": "A String", # The thumbnail image's URL.
Joe Gregorio41be8e82013-03-07 10:31:47 -0500[diff] [blame]268 "width": 42, # (Optional) Width of the thumbnail image.
269 "height": 42, # (Optional) Height of the thumbnail image.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]270 },
271 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]272 "title": "A String", # The title of the resource primarily associated with the activity.
273 "channelId": "A String", # The ID that YouTube uses to uniquely identify the channel associated with the activity.
Joe Gregorio41be8e82013-03-07 10:31:47 -0500[diff] [blame]274 "publishedAt": "A String", # The date and time that the video was uploaded. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
275 "channelTitle": "A String", # Channel title for the channel responsible for this activity
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]276 "type": "A String", # The type of activity that the resource describes.
277 "groupId": "A 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.
278 "description": "A String", # The description of the resource primarily associated with the activity.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]279 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]280 "contentDetails": { # Details about the content of an activity: the video that was shared, the channel that was subscribed to, etc. # The contentDetails object contains information about the content associated with the activity. For example, if the snippet.type value is videoRated, then the contentDetails object's content identifies the rated video.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]281 "comment": { # Information about a resource that received a comment. # The comment object contains information about a resource that received a comment. This property is only present if the snippet.type is comment.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]282 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource associated with the comment.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]283 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]284 "channelId": "A 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.
285 "playlistId": "A 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.
286 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]287 },
288 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]289 "playlistItem": { # Information about a new playlist item. # The playlistItem object contains information about a new playlist item. This property is only present if the snippet.type is playlistItem.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]290 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information about the resource that was added to the playlist.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]291 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]292 "channelId": "A 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.
293 "playlistId": "A 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.
294 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]295 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]296 "playlistId": "A String", # The value that YouTube uses to uniquely identify the playlist.
297 "playlistItemId": "A String", # ID of the item within the playlist.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]298 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]299 "like": { # Information about a resource that received a positive (like) rating. # The like object contains information about a resource that received a positive (like) rating. This property is only present if the snippet.type is like.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]300 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the rated resource.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]301 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]302 "channelId": "A 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.
303 "playlistId": "A 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.
304 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]305 },
306 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]307 "promotedItem": { # Details about a resource which is being promoted. # The promotedItem object contains details about a resource which is being promoted. This property is only present if the snippet.type is promotedItem.
308 "ctaType": "A String", # The type of call-to-action, a message to the user indicating action that can be taken.
309 "adTag": "A String", # The URL the client should fetch to request a promoted item.
310 "destinationUrl": "A String", # The URL the client should direct the user to, if the user chooses to visit the advertiser's website.
311 "creativeViewUrl": "A String", # The URL the client should ping to indicate that the user was shown this promoted item.
312 "videoId": "A String", # The ID that YouTube uses to uniquely identify the promoted video.
313 "descriptionText": "A String", # The text description to accompany the promoted item.
314 "clickTrackingUrl": "A String", # The URL the client should ping to indicate that the user clicked through on this promoted item.
315 },
316 "social": { # Details about a social network post. # The social object contains details about a social network post. This property is only present if the snippet.type is social.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]317 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object encapsulates information that identifies the resource associated with a social network post.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]318 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]319 "channelId": "A 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.
320 "playlistId": "A 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.
321 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]322 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]323 "imageUrl": "A String", # An image of the post's author.
324 "type": "A String", # The name of the social network.
325 "referenceUrl": "A String", # The URL of the social network post.
326 "author": "A String", # The author of the social network post.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]327 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]328 "favorite": { # Information about a video that was marked as a favorite video. # The favorite object contains information about a video that was marked as a favorite video. This property is only present if the snippet.type is favorite.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]329 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource that was marked as a favorite.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]330 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]331 "channelId": "A 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.
332 "playlistId": "A 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.
333 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]334 },
335 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]336 "upload": { # Information about the uploaded video. # The upload object contains information about the uploaded video. This property is only present if the snippet.type is upload.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]337 "videoId": "A String", # The ID that YouTube uses to uniquely identify the uploaded video.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]338 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]339 "recommendation": { # Information that identifies the recommended resource. # The recommendation object contains information about a recommended resource. This property is only present if the snippet.type is recommendation.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]340 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the recommended resource.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]341 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]342 "channelId": "A 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.
343 "playlistId": "A 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.
344 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]345 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]346 "reason": "A String", # The reason that the resource is recommended to the user.
347 "seedResourceId": { # A resource id is a generic reference that points to another YouTube resource. # The seedResourceId object contains information about the resource that caused the recommendation.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]348 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]349 "channelId": "A 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.
350 "playlistId": "A 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.
351 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]352 },
353 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]354 "subscription": { # Information about a channel that a user subscribed to. # The subscription object contains information about a channel that a user subscribed to. This property is only present if the snippet.type is subscription.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]355 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource that the user subscribed to.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]356 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]357 "channelId": "A 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.
358 "playlistId": "A 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.
359 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]360 },
361 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]362 "bulletin": { # Details about a channel bulletin post. # The bulletin object contains details about a channel bulletin post. This object is only present if the snippet.type is bulletin.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]363 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource associated with a bulletin post.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]364 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]365 "channelId": "A 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.
366 "playlistId": "A 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.
367 "videoId": "A 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.
368 },
369 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]370 "channelItem": { # Details about a resource which was added to a channel. # The channelItem object contains details about a resource which was added to a channel. This property is only present if the snippet.type is channelItem.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]371 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource that was added to the channel.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]372 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]373 "channelId": "A 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.
374 "playlistId": "A 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.
375 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]376 },
377 },
378 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]379 "kind": "youtube#activity", # The kind, fixed to "youtube#activity".
380 "etag": "A String", # Etag of this resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]381 "id": "A String", # The ID that YouTube uses to uniquely identify the activity.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]382 }</pre>
383</div>
384
385<div class="method">
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]386 <code class="details" id="list">list(part=None, pageToken=None, publishedBefore=None, channelId=None, mine=None, maxResults=None, regionCode=None, home=None, publishedAfter=None)</code>
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]387 <pre>Returns a list of channel activity events that match the request criteria. For example, you can retrieve events associated with a particular channel, events associated with the user's subscriptions and Google+ friends, or the YouTube home page feed, which is customized for each user.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]388
389Args:
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]390 part: string, The part parameter specifies a comma-separated list of one or more activity resource properties that the API response will include. The part names that you can include in the parameter value are id, snippet, and contentDetails.
391
392If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a activity resource, the snippet property contains other properties that identify the type of activity, a display title for the activity, and so forth. If you set part=snippet, the API response will also contain all of those nested properties. (required)
393 pageToken: string, USE_DESCRIPTION --- channels:list:pageToken
394 publishedBefore: string, The publishedBefore parameter specifies the date and time before which an activity must have occurred for that activity to be included in the API response. If the parameter value specifies a day, but not a time, then any activities that occurred that day will be excluded from the result set. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
395 channelId: string, The channelId parameter specifies a unique YouTube channel ID. The API will then return a list of that channel's activities.
396 mine: boolean, Set this parameter's value to true to retrieve a feed of the authenticated user's activities.
397 maxResults: integer, USE_DESCRIPTION --- channels:list:maxResults
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]398 regionCode: string, The regionCode parameter instructs the API to return results for the specified country. The parameter value is an ISO 3166-1 alpha-2 country code.
399 home: boolean, Set this parameter's value to true to retrieve the activity feed that displays on the YouTube home page for the currently authenticated user.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]400 publishedAfter: string, The publishedAfter parameter specifies the earliest date and time that an activity could have occurred for that activity to be included in the API response. If the parameter value specifies a day, but not a time, then any activities that occurred that day will be included in the result set. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]401
402Returns:
403 An object of the form:
404
405 { # A paginated list of activities returned as a response to youtube.activities.list calls.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]406 "eventId": "A String", # Serialized EventId of the request which produced this response.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]407 "nextPageToken": "A String", # The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.
408 "kind": "youtube#activityListResponse", # The type of the API response. For this operation, the value will be youtube#activityListResponse.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]409 "visitorId": "A String", # The visitorId identifies the visitor.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]410 "items": [ # A list of activities, or events, that match the request criteria.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]411 { # An activity resource contains information about an action that a particular channel, or user, has taken on YouTube.The actions reported in activity feeds include rating a video, sharing a video, marking a video as a favorite, commenting on a video, uploading a video, and so forth. Each activity resource identifies the type of action, the channel associated with the action, and the resource(s) associated with the action, such as the video that was rated or uploaded.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]412 "snippet": { # Basic details about an activity, including title, description, thumbnails, activity type and group. # The snippet object contains basic details about the activity, including the activity's type and group ID.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]413 "thumbnails": { # Internal representation of thumbnails for a YouTube resource. # A map of thumbnail images associated with the resource that is primarily associated with the activity. For each object in the map, the key is the name of the thumbnail image, and the value is an object that contains other information about the thumbnail.
414 "default": { # A thumbnail is an image representing a YouTube resource. # The default image for this resource.
415 "url": "A String", # The thumbnail image's URL.
416 "width": 42, # (Optional) Width of the thumbnail image.
417 "height": 42, # (Optional) Height of the thumbnail image.
418 },
419 "high": { # A thumbnail is an image representing a YouTube resource. # The high quality image for this resource.
420 "url": "A String", # The thumbnail image's URL.
421 "width": 42, # (Optional) Width of the thumbnail image.
422 "height": 42, # (Optional) Height of the thumbnail image.
423 },
424 "medium": { # A thumbnail is an image representing a YouTube resource. # The medium quality image for this resource.
425 "url": "A String", # The thumbnail image's URL.
426 "width": 42, # (Optional) Width of the thumbnail image.
427 "height": 42, # (Optional) Height of the thumbnail image.
428 },
429 "maxres": { # A thumbnail is an image representing a YouTube resource. # The maximum resolution quality image for this resource.
430 "url": "A String", # The thumbnail image's URL.
431 "width": 42, # (Optional) Width of the thumbnail image.
432 "height": 42, # (Optional) Height of the thumbnail image.
433 },
434 "standard": { # A thumbnail is an image representing a YouTube resource. # The standard quality image for this resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]435 "url": "A String", # The thumbnail image's URL.
Joe Gregorio41be8e82013-03-07 10:31:47 -0500[diff] [blame]436 "width": 42, # (Optional) Width of the thumbnail image.
437 "height": 42, # (Optional) Height of the thumbnail image.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]438 },
439 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]440 "title": "A String", # The title of the resource primarily associated with the activity.
441 "channelId": "A String", # The ID that YouTube uses to uniquely identify the channel associated with the activity.
Joe Gregorio41be8e82013-03-07 10:31:47 -0500[diff] [blame]442 "publishedAt": "A String", # The date and time that the video was uploaded. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
443 "channelTitle": "A String", # Channel title for the channel responsible for this activity
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]444 "type": "A String", # The type of activity that the resource describes.
445 "groupId": "A 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.
446 "description": "A String", # The description of the resource primarily associated with the activity.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]447 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]448 "contentDetails": { # Details about the content of an activity: the video that was shared, the channel that was subscribed to, etc. # The contentDetails object contains information about the content associated with the activity. For example, if the snippet.type value is videoRated, then the contentDetails object's content identifies the rated video.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]449 "comment": { # Information about a resource that received a comment. # The comment object contains information about a resource that received a comment. This property is only present if the snippet.type is comment.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]450 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource associated with the comment.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]451 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]452 "channelId": "A 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.
453 "playlistId": "A 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.
454 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]455 },
456 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]457 "playlistItem": { # Information about a new playlist item. # The playlistItem object contains information about a new playlist item. This property is only present if the snippet.type is playlistItem.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]458 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information about the resource that was added to the playlist.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]459 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]460 "channelId": "A 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.
461 "playlistId": "A 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.
462 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]463 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]464 "playlistId": "A String", # The value that YouTube uses to uniquely identify the playlist.
465 "playlistItemId": "A String", # ID of the item within the playlist.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]466 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]467 "like": { # Information about a resource that received a positive (like) rating. # The like object contains information about a resource that received a positive (like) rating. This property is only present if the snippet.type is like.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]468 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the rated resource.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]469 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]470 "channelId": "A 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.
471 "playlistId": "A 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.
472 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]473 },
474 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]475 "promotedItem": { # Details about a resource which is being promoted. # The promotedItem object contains details about a resource which is being promoted. This property is only present if the snippet.type is promotedItem.
476 "ctaType": "A String", # The type of call-to-action, a message to the user indicating action that can be taken.
477 "adTag": "A String", # The URL the client should fetch to request a promoted item.
478 "destinationUrl": "A String", # The URL the client should direct the user to, if the user chooses to visit the advertiser's website.
479 "creativeViewUrl": "A String", # The URL the client should ping to indicate that the user was shown this promoted item.
480 "videoId": "A String", # The ID that YouTube uses to uniquely identify the promoted video.
481 "descriptionText": "A String", # The text description to accompany the promoted item.
482 "clickTrackingUrl": "A String", # The URL the client should ping to indicate that the user clicked through on this promoted item.
483 },
484 "social": { # Details about a social network post. # The social object contains details about a social network post. This property is only present if the snippet.type is social.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]485 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object encapsulates information that identifies the resource associated with a social network post.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]486 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]487 "channelId": "A 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.
488 "playlistId": "A 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.
489 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]490 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]491 "imageUrl": "A String", # An image of the post's author.
492 "type": "A String", # The name of the social network.
493 "referenceUrl": "A String", # The URL of the social network post.
494 "author": "A String", # The author of the social network post.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]495 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]496 "favorite": { # Information about a video that was marked as a favorite video. # The favorite object contains information about a video that was marked as a favorite video. This property is only present if the snippet.type is favorite.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]497 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource that was marked as a favorite.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]498 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]499 "channelId": "A 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.
500 "playlistId": "A 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.
501 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]502 },
503 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]504 "upload": { # Information about the uploaded video. # The upload object contains information about the uploaded video. This property is only present if the snippet.type is upload.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]505 "videoId": "A String", # The ID that YouTube uses to uniquely identify the uploaded video.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]506 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]507 "recommendation": { # Information that identifies the recommended resource. # The recommendation object contains information about a recommended resource. This property is only present if the snippet.type is recommendation.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]508 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the recommended resource.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]509 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]510 "channelId": "A 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.
511 "playlistId": "A 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.
512 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]513 },
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]514 "reason": "A String", # The reason that the resource is recommended to the user.
515 "seedResourceId": { # A resource id is a generic reference that points to another YouTube resource. # The seedResourceId object contains information about the resource that caused the recommendation.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]516 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]517 "channelId": "A 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.
518 "playlistId": "A 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.
519 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]520 },
521 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]522 "subscription": { # Information about a channel that a user subscribed to. # The subscription object contains information about a channel that a user subscribed to. This property is only present if the snippet.type is subscription.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]523 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource that the user subscribed to.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]524 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]525 "channelId": "A 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.
526 "playlistId": "A 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.
527 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]528 },
529 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]530 "bulletin": { # Details about a channel bulletin post. # The bulletin object contains details about a channel bulletin post. This object is only present if the snippet.type is bulletin.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]531 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource associated with a bulletin post.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]532 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]533 "channelId": "A 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.
534 "playlistId": "A 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.
535 "videoId": "A 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.
536 },
537 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]538 "channelItem": { # Details about a resource which was added to a channel. # The channelItem object contains details about a resource which was added to a channel. This property is only present if the snippet.type is channelItem.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]539 "resourceId": { # A resource id is a generic reference that points to another YouTube resource. # The resourceId object contains information that identifies the resource that was added to the channel.
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]540 "kind": "A String", # The type of the API resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]541 "channelId": "A 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.
542 "playlistId": "A 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.
543 "videoId": "A 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.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]544 },
545 },
546 },
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]547 "kind": "youtube#activity", # The kind, fixed to "youtube#activity".
548 "etag": "A String", # Etag of this resource.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]549 "id": "A String", # The ID that YouTube uses to uniquely identify the activity.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]550 },
551 ],
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]552 "etag": "A String", # The ETag of the response.
553 "prevPageToken": "A String", # The token that can be used as the value of the pageToken parameter to retrieve the previous page in the result set.
554 "pageInfo": { # Paging details for lists of resources, including total number of items available and number of resources returned in a single page. # The pageInfo object encapsulates paging information for the result set.
555 "totalResults": 42, # The total number of results in the result set.
556 "resultsPerPage": 42, # The number of results included in the API response.
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]557 },
558 }</pre>
559</div>
560
561<div class="method">
562 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
563 <pre>Retrieves the next page of results.
564
565Args:
566 previous_request: The request for the previous page. (required)
567 previous_response: The response from the request for the previous page. (required)
568
569Returns:
570 A request object that you can call 'execute()' on to request the next
571 page. Returns None if there are no more items in the collection.
Joe Gregorio52a5c532013-01-24 16:19:07 -0500[diff] [blame]572 </pre>
Joe Gregoriod67010d2012-11-05 08:57:06 -0500[diff] [blame]573</div>
574
575</body></html>