@@ -9,7 +9,7 @@ and content.<br><br>
9
9
This sample also updates the channel's
10
10
<code ><a href =" /youtube/v3/docs/channels#brandingSettings.channel.showBrowseView " >brandingSettings.channel.showBrowseView</a ></code >
11
11
property so that the channel displays content in a browse view (rather than a feed view). A channel's sections are only
12
- visible if the channel displays content in a browse view.</ p >< p >More information on channel sections is available in the
12
+ visible if the channel displays content in a browse view.<br >< br >More information on channel sections is available in the
13
13
<a href =" https://support.google.com/youtube/answer/3027787 " >YouTube Help Center</a >.
14
14
15
15
### [ Add a channel subscription] ( /youtube/api-samples/blob/master/php/add_subscription.php )
@@ -18,51 +18,11 @@ Method: youtube.subscriptions.insert<br>
18
18
Description: This sample calls the API's <code >subscriptions.insert</code > method to add a subscription to a specified
19
19
channel.
20
20
21
- ### [ Create and manage YouTube video caption tracks] ( /youtube/api-samples/blob/master/php/captions.php )
22
-
23
- Method: youtube.captions.insert, youtube.captions.list, youtube.captions.update, youtube.captions.download,
24
- youtube.captions.delete<br >
25
- Description: This sample demonstrates how to use the following API methods to create and manage YouTube video caption
26
- tracks:<br >
27
- <ul >
28
- <li >It calls the <code >captions.insert</code > method with the <code >isDraft</code > parameter set to <code >true</code >
29
- to upload a caption track in draft status.</li >
30
- <li >It calls the <code >captions.list</code > method with the <code >videoId</code > parameter to retrieve video caption
31
- tracks.</li >
32
- <li >It calls the <code >captions.update</code > method with the caption in the request body to update a caption track.</li >
33
- <li >It calls the <code >captions.download</code > method to download the caption track.</li >
34
- <li >It calls the <code >captions.delete</code > method to delete the caption track, using the <code >id</code > parameter to
35
- identify the caption track.</li >
36
- </ul >
37
-
38
- ### [ Set and retrieve localized channel metadata] ( /youtube/api-samples/blob/master/php/channel_localizations.php )
39
-
40
- Method: youtube.channels.update, youtube.channels.list<br >
41
- Description: This sample demonstrates how to use the following API methods to set and retrieve localized metadata for a
42
- channel:<br >
43
- <ul >
44
- <li >It calls the <code >channels.update</code > method to update the default language of a channel's metadata and to add a
45
- localized version of this metadata in a selected language. Note that to set the default language for a channel resource,
46
- you actually need to update the <code >brandingSettings.channel.defaultLanguage</code > property.</li >
47
- <li >It calls the <code >channels.list</code > method with the <code >hl</code > parameter set to a specific language to
48
- retrieve localized metadata in that language.</li >
49
- <li >It calls the <code >channels.list</code > method and includes <code >localizations</code > in the <code >part</code >
50
- parameter value to retrieve all of the localized metadata for that channel.</li >
51
- </ul >
52
-
53
- ### [ Set and retrieve localized channel section metadata] ( /youtube/api-samples/blob/master/php/channel_section_localizations.php )
21
+ ### [ Create a playlist] ( /youtube/api-samples/blob/master/php/playlist_updates.php )
54
22
55
- Method: youtube.channelSections.update, youtube.channelSections.list<br >
56
- Description: This sample demonstrates how to use the following API methods to set and retrieve localized metadata for a
57
- channel section:<br >
58
- <ul >
59
- <li >It calls the <code >channelSections.update</code > method to update the default language of a channel section's
60
- metadata and to add a localized version of this metadata in a selected language.</li >
61
- <li >It calls the <code >channelSections.list</code > method with the <code >hl</code > parameter set to a specific language
62
- to retrieve localized metadata in that language.</li >
63
- <li >It calls the <code >channelSections.list</code > method and includes <code >localizations</code > in the
64
- <code >part</code > parameter value to retrieve all of the localized metadata for that channel section.</li >
65
- </ul >
23
+ Method: youtube.playlists.insert<br >
24
+ Description: This sample calls the API's <code >playlists.insert</code > method to create a private playlist owned by the
25
+ channel authorizing the request.
66
26
67
27
### [ Create and manage comments] ( /youtube/api-samples/blob/master/php/comment_handling.php )
68
28
@@ -95,46 +55,73 @@ channel comments and once with the <code>videoId</code> parameter to retrieve vi
95
55
channel comment. In each case, the request body contains the <code >comment</code > resource being updated.</li >
96
56
</ul >
97
57
98
- ### [ Create a broadcast ] ( /youtube/api-samples/blob/master/php/create_broadcast .php )
58
+ ### [ Create and manage YouTube video caption tracks ] ( /youtube/api-samples/blob/master/php/captions .php )
99
59
100
- Method: youtube.liveBroadcasts.bind,youtube.liveBroadcasts.insert,youtube.liveStreams.insert<br >
101
- Description: This sample calls the API's <code >liveBroadcasts.insert</code > method to create a broadcast.
60
+ Method: youtube.captions.insert, youtube.captions.list, youtube.captions.update, youtube.captions.download,
61
+ youtube.captions.delete<br >
62
+ Description: This sample demonstrates how to use the following API methods to create and manage YouTube video caption
63
+ tracks:<br >
64
+ <ul >
65
+ <li >It calls the <code >captions.insert</code > method with the <code >isDraft</code > parameter set to <code >true</code >
66
+ to upload a caption track in draft status.</li >
67
+ <li >It calls the <code >captions.list</code > method with the <code >videoId</code > parameter to retrieve video caption
68
+ tracks.</li >
69
+ <li >It calls the <code >captions.update</code > method with the caption in the request body to update a caption track.</li >
70
+ <li >It calls the <code >captions.download</code > method to download the caption track.</li >
71
+ <li >It calls the <code >captions.delete</code > method to delete the caption track, using the <code >id</code > parameter to
72
+ identify the caption track.</li >
73
+ </ul >
102
74
103
- ### [ Create a reporting job ] ( /youtube/api-samples/blob/master/php/create_reporting_job .php )
75
+ ### [ Retrieve my uploads ] ( /youtube/api-samples/blob/master/php/my_uploads .php )
104
76
105
- Method: youtubeReporting.reportTypes.list, youtubeReporting.jobs.create<br >
106
- Description: This sample demonstrates how to create a reporting job. It calls the <code >reportTypes.list</code > method
107
- to retrieve a list of available report types. It then calls the <code >jobs.create</code > method to create a new reporting
108
- job.
77
+ Method: youtube.playlistItems.list<br >
78
+ Description: This sample calls the API's <code >playlistItems.list</code > method to retrieve a list of videos uploaded
79
+ to the channel associated with the request. The code also calls the <code >channels.list</code > method with the
80
+ <code >mine</code > parameter set to <code >true</code > to retrieve the playlist ID that identifies the channel's uploaded
81
+ videos.
82
+
83
+ ### [ Search by keyword] ( /youtube/api-samples/blob/master/php/search.php )
109
84
110
- ### [ Search by geolocation] ( /youtube/api-samples/blob/master/php/geolocation_search.php )
85
+ Method: youtube.search.list<br >
86
+ Description: This sample calls the API's <code >search.list</code > method to retrieve search results associated with
87
+ a particular keyword.
88
+
89
+ ### [ Search by location] ( /youtube/api-samples/blob/master/php/geolocation_search.php )
111
90
112
91
Method: youtube.search.list, youtube.videos.list<br >
113
92
Description: This sample calls the API's <code >search.list</code > method with the <code >type</code >, <code >q</code >,
114
93
<code >location</code > and <code >locationRadius</code > parameters to retrieve search results matching the provided
115
94
keyword within the radius centered at a particular location. Using the video IDs from the search result, the sample
116
95
calls the API's <code >videos.list</code > method to retrieve location details of each video.
117
96
118
- ### [ Retrieve a channel's broadcasts] ( /youtube/api-samples/blob/master/php/list_broadcasts.php )
119
-
120
- Method: youtube.liveBroadcasts.list<br >
121
- Description: This sample calls the API's <code >liveBroadcasts.list</code > method to retrieve a list of broadcasts for
122
- the channel associated with the request. By default, the request retrieves all broadcasts for the channel, but you can
123
- also specify a value for the <code >--broadcast-status</code > option to only retrieve broadcasts with a particular status.
124
-
125
- ### [ Retrieve a channel's live video streams] ( /youtube/api-samples/blob/master/php/list_streams.php )
97
+ ### [ Set and retrieve localized channel metadata] ( /youtube/api-samples/blob/master/php/channel_localizations.php )
126
98
127
- Method: youtube.liveStreams.list<br >
128
- Description: This sample calls the API's <code >liveStreams.list</code > method to retrieve a list of video stream settings
129
- that a channel can use to broadcast live events on YouTube.
99
+ Method: youtube.channels.update, youtube.channels.list<br >
100
+ Description: This sample demonstrates how to use the following API methods to set and retrieve localized metadata for a
101
+ channel:<br >
102
+ <ul >
103
+ <li >It calls the <code >channels.update</code > method to update the default language of a channel's metadata and to add a
104
+ localized version of this metadata in a selected language. Note that to set the default language for a channel resource,
105
+ you actually need to update the <code >brandingSettings.channel.defaultLanguage</code > property.</li >
106
+ <li >It calls the <code >channels.list</code > method with the <code >hl</code > parameter set to a specific language to
107
+ retrieve localized metadata in that language.</li >
108
+ <li >It calls the <code >channels.list</code > method and includes <code >localizations</code > in the <code >part</code >
109
+ parameter value to retrieve all of the localized metadata for that channel.</li >
110
+ </ul >
130
111
131
- ### [ Retrieve my uploads ] ( /youtube/api-samples/blob/master/php/my_uploads .php )
112
+ ### [ Set and retrieve localized channel section metadata ] ( /youtube/api-samples/blob/master/php/channel_section_localizations .php )
132
113
133
- Method: youtube.playlistItems.list<br >
134
- Description: This sample calls the API's <code >playlistItems.list</code > method to retrieve a list of videos uploaded
135
- to the channel associated with the request. The code also calls the <code >channels.list</code > method with the
136
- <code >mine</code > parameter set to <code >true</code > to retrieve the playlist ID that identifies the channel's uploaded
137
- videos.
114
+ Method: youtube.channelSections.update, youtube.channelSections.list<br >
115
+ Description: This sample demonstrates how to use the following API methods to set and retrieve localized metadata for a
116
+ channel section:<br >
117
+ <ul >
118
+ <li >It calls the <code >channelSections.update</code > method to update the default language of a channel section's
119
+ metadata and to add a localized version of this metadata in a selected language.</li >
120
+ <li >It calls the <code >channelSections.list</code > method with the <code >hl</code > parameter set to a specific language
121
+ to retrieve localized metadata in that language.</li >
122
+ <li >It calls the <code >channelSections.list</code > method and includes <code >localizations</code > in the
123
+ <code >part</code > parameter value to retrieve all of the localized metadata for that channel section.</li >
124
+ </ul >
138
125
139
126
### [ Set and retrieve localized playlist metadata] ( /youtube/api-samples/blob/master/php/playlist_localizations.php )
140
127
@@ -150,32 +137,19 @@ retrieve localized metadata in that language.</li>
150
137
parameter value to retrieve all of the localized metadata for that playlist.</li >
151
138
</ul >
152
139
153
- ### [ Create a playlist] ( /youtube/api-samples/blob/master/php/playlist_updates.php )
154
-
155
- Method: youtube.playlists.insert<br >
156
- Description: This sample calls the API's <code >playlists.insert</code > method to create a private playlist owned by the
157
- channel authorizing the request.
158
-
159
- ### [ Upload a video] ( /youtube/api-samples/blob/master/php/resumable_upload.php )
140
+ ### [ Set and retrieve localized video metadata] ( /youtube/api-samples/blob/master/php/video_localizations.php )
160
141
161
- Method: youtube.videos.insert<br >
162
- Description: The following code sample calls the API's <code >videos.insert</code > method to add a video to user's
163
- channel. The code also utilizes <code >Google_MediaFileUpload</code > class with the <code >resumable upload</code >
164
- parameter set to <code >true</code > to be able to to upload the video in chunks.
165
-
166
- ### [ Retrieve reports] ( /youtube/api-samples/blob/master/php/retrieve_reports.php )
167
-
168
- Method: youtubeReporting.jobs.list, youtubeReporting.reports.list<br >
169
- Description: This sample demonstrates how to retrieve reports created by a specific job. It calls the
170
- <code >jobs.list</code > method to retrieve reporting jobs. It then calls the <code >reports.list</code > method with the
171
- <code >jobId</code > parameter set to a specific job id to retrieve reports created by that job. Finally, the sample
172
- prints out the download URL for each report.
173
-
174
- ### [ Search by keyword] ( /youtube/api-samples/blob/master/php/search.php )
175
-
176
- Method: youtube.search.list<br >
177
- Description: This sample calls the API's <code >search.list</code > method to retrieve search results associated with
178
- a particular keyword.
142
+ Method: youtube.videos.update, youtube.videos.list<br >
143
+ Description: This sample demonstrates how to use the following API methods to set and retrieve localized metadata
144
+ for a video:<br >
145
+ <ul >
146
+ <li >It calls the <code >videos.update</code > method to update the default language of a video's metadata and to add
147
+ a localized version of this metadata in a selected language.</li >
148
+ <li >It calls the <code >videos.list</code > method with the <code >hl</code > parameter set to a specific language to
149
+ retrieve localized metadata in that language.</li >
150
+ <li >It calls the <code >videos.list</code > method and includes <code >localizations</code > in the <code >part</code >
151
+ parameter value to retrieve all of the localized metadata for that video.</li >
152
+ </ul >
179
153
180
154
### [ Shuffle existing channel sections] ( /youtube/api-samples/blob/master/php/shuffle_channel_sections.php )
181
155
@@ -210,16 +184,42 @@ ID to use a custom image as a thumbnail to the video. For the image upload, the
210
184
<code >true</code > to upload the image piece-by-piece, allowing for subsequent retries to resume uploading from
211
185
a point close to where the previous retry failed, a feature useful for programs that need to upload large files.
212
186
213
- ### [ Set and retrieve localized metadata for a video] ( /youtube/api-samples/blob/master/php/video_localizations .php )
187
+ ### [ Upload a video] ( /youtube/api-samples/blob/master/php/resumable_upload .php )
214
188
215
- Method: youtube.videos.update, youtube.videos.list<br >
216
- Description: This sample demonstrates how to use the following API methods to set and retrieve localized metadata
217
- for a video:<br >
218
- <ul >
219
- <li >It calls the <code >videos.update</code > method to update the default language of a video's metadata and to add
220
- a localized version of this metadata in a selected language.</li >
221
- <li >It calls the <code >videos.list</code > method with the <code >hl</code > parameter set to a specific language to
222
- retrieve localized metadata in that language.</li >
223
- <li >It calls the <code >videos.list</code > method and includes <code >localizations</code > in the <code >part</code >
224
- parameter value to retrieve all of the localized metadata for that video.</li >
225
- </ul >
189
+ Method: youtube.videos.insert<br >
190
+ Description: The following code sample calls the API's <code >videos.insert</code > method to add a video to user's
191
+ channel. The code also utilizes <code >Google_MediaFileUpload</code > class with the <code >resumable upload</code >
192
+ parameter set to <code >true</code > to be able to to upload the video in chunks.
193
+
194
+ ### [ Create a broadcast] ( /youtube/api-samples/blob/master/php/create_broadcast.php )
195
+
196
+ Method: youtube.liveBroadcasts.bind,youtube.liveBroadcasts.insert,youtube.liveStreams.insert<br >
197
+ Description: This sample calls the API's <code >liveBroadcasts.insert</code > method to create a broadcast.
198
+
199
+ ### [ Retrieve a channel's broadcasts] ( /youtube/api-samples/blob/master/php/list_broadcasts.php )
200
+
201
+ Method: youtube.liveBroadcasts.list<br >
202
+ Description: This sample calls the API's <code >liveBroadcasts.list</code > method to retrieve a list of broadcasts for
203
+ the channel associated with the request. By default, the request retrieves all broadcasts for the channel, but you can
204
+ also specify a value for the <code >--broadcast-status</code > option to only retrieve broadcasts with a particular status.
205
+
206
+ ### [ Retrieve a channel's live video streams] ( /youtube/api-samples/blob/master/php/list_streams.php )
207
+
208
+ Method: youtube.liveStreams.list<br >
209
+ Description: This sample calls the API's <code >liveStreams.list</code > method to retrieve a list of video stream settings
210
+ that a channel can use to broadcast live events on YouTube.
211
+
212
+ ### [ Create a reporting job] ( /youtube/api-samples/blob/master/php/create_reporting_job.php )
213
+
214
+ Method: youtubeReporting.reportTypes.list, youtubeReporting.jobs.create<br >
215
+ Description: This sample demonstrates how to create a reporting job. It calls the <code >reportTypes.list</code > method
216
+ to retrieve a list of available report types. It then calls the <code >jobs.create</code > method to create a new reporting
217
+ job.
218
+
219
+ ### [ Retrieve reports] ( /youtube/api-samples/blob/master/php/retrieve_reports.php )
220
+
221
+ Method: youtubeReporting.jobs.list, youtubeReporting.reports.list<br >
222
+ Description: This sample demonstrates how to retrieve reports created by a specific job. It calls the
223
+ <code >jobs.list</code > method to retrieve reporting jobs. It then calls the <code >reports.list</code > method with the
224
+ <code >jobId</code > parameter set to a specific job id to retrieve reports created by that job. Finally, the sample
225
+ prints out the download URL for each report.
0 commit comments