blob: 5cf5bbd267477890d7c9d706be78148aeec77dc1 [file] [log] [blame]
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001<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
75<h1><a href="youtubeAnalytics_v2.html">YouTube Analytics API</a> . <a href="youtubeAnalytics_v2.groupItems.html">groupItems</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -070078 <code><a href="#delete">delete(id=None, onBehalfOfContentOwner=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070079<p class="firstline">Removes an item from a group.</p>
80<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070081 <code><a href="#insert">insert(body=None, onBehalfOfContentOwner=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070082<p class="firstline">Creates a group item.</p>
83<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -070084 <code><a href="#list">list(groupId=None, onBehalfOfContentOwner=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070085<p class="firstline">Returns a collection of group items that match the API request parameters.</p>
86<h3>Method Details</h3>
87<div class="method">
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -070088 <code class="details" id="delete">delete(id=None, onBehalfOfContentOwner=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070089 <pre>Removes an item from a group.
90
91Args:
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -070092 id: string, The `id` parameter specifies the YouTube group item ID of the group item
93that is being deleted.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070094 onBehalfOfContentOwner: string, This parameter can only be used in a properly authorized request. **Note:**
95This parameter is intended exclusively for YouTube content partners that
96own and manage many different YouTube channels.
97
Bu Sun Kim65020912020-05-20 12:08:20 -070098The `onBehalfOfContentOwner` parameter indicates that the request&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070099authorization credentials identify a YouTube user who is acting on behalf
100of the content owner specified in the parameter value. It allows content
101owners to authenticate once and get access to all their video and channel
102data, without having to provide authentication credentials for each
103individual channel. The account that the user authenticates with must be
104linked to the specified YouTube content owner.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700105 x__xgafv: string, V1 error format.
106 Allowed values
107 1 - v1 error format
108 2 - v2 error format
109
110Returns:
111 An object of the form:
112
113 { # Empty response.
Bu Sun Kim65020912020-05-20 12:08:20 -0700114 &quot;errors&quot;: { # Request Error information. # Apiary error details
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700115 #
116 # The presence of an error field signals that the operation
117 # has failed.
Bu Sun Kim65020912020-05-20 12:08:20 -0700118 &quot;requestId&quot;: &quot;A String&quot;, # Request identifier generated by the service, which can be
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700119 # used to identify the error in the logs
Bu Sun Kim65020912020-05-20 12:08:20 -0700120 &quot;error&quot;: [ # Specific error description and codes
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700121 { # Describes one specific error.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700122 &quot;debugInfo&quot;: &quot;A String&quot;, # Debugging information, which should not be
123 # shared externally.
124 &quot;argument&quot;: [ # Error arguments, to be used when building user-friendly error messages
125 # given the error domain and code. Different error codes require different
126 # arguments.
127 &quot;A String&quot;,
128 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700129 &quot;code&quot;: &quot;A String&quot;, # Error code in the error domain. This should correspond to
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700130 # a value of the enum type whose name is in domain. See
131 # the core error domain in error_domain.proto.
Bu Sun Kim65020912020-05-20 12:08:20 -0700132 &quot;domain&quot;: &quot;A String&quot;, # Error domain. RoSy services can define their own
133 # domain and error codes. This should normally be
134 # the name of an enum type, such as: gdata.CoreErrorDomain
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700135 &quot;locationType&quot;: &quot;A String&quot;,
Bu Sun Kim65020912020-05-20 12:08:20 -0700136 &quot;location&quot;: &quot;A String&quot;, # Location of the error, as specified by the location type.
137 #
138 # If location_type is PATH, this should be a path to a field that&#x27;s
139 # relative to the request, using FieldPath notation
140 # (net/proto2/util/public/field_path.h).
141 #
142 # Examples:
143 # authenticated_user.gaia_id
144 # resource.address[2].country
Bu Sun Kim65020912020-05-20 12:08:20 -0700145 &quot;externalErrorMessage&quot;: &quot;A String&quot;, # A short explanation for the error, which can be shared outside Google.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700146 #
147 # Please set domain, code and arguments whenever possible instead of this
148 # error message so that external APIs can build safe error messages
149 # themselves.
150 #
151 # External messages built in a RoSy interface will most likely refer to
152 # information and concepts that are not available externally and should not
153 # be exposed. It is safer if external APIs can understand the errors and
154 # decide what the error message should look like.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700155 },
156 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700157 &quot;code&quot;: &quot;A String&quot;, # Global error code. Deprecated and ignored.
158 # Set custom error codes in ErrorProto.domain and ErrorProto.code
159 # instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700160 },
161 }</pre>
162</div>
163
164<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700165 <code class="details" id="insert">insert(body=None, onBehalfOfContentOwner=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700166 <pre>Creates a group item.
167
168Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700169 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700170 The object takes the form of:
171
172{ # A group item.
Bu Sun Kim65020912020-05-20 12:08:20 -0700173 &quot;groupId&quot;: &quot;A String&quot;, # The ID that YouTube uses to uniquely identify the group that contains the
174 # item.
Bu Sun Kim65020912020-05-20 12:08:20 -0700175 &quot;errors&quot;: { # Request Error information. # Apiary error details
176 #
177 # The presence of an error field signals that the operation
178 # has failed.
Bu Sun Kim65020912020-05-20 12:08:20 -0700179 &quot;requestId&quot;: &quot;A String&quot;, # Request identifier generated by the service, which can be
180 # used to identify the error in the logs
181 &quot;error&quot;: [ # Specific error description and codes
182 { # Describes one specific error.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700183 &quot;debugInfo&quot;: &quot;A String&quot;, # Debugging information, which should not be
184 # shared externally.
185 &quot;argument&quot;: [ # Error arguments, to be used when building user-friendly error messages
186 # given the error domain and code. Different error codes require different
187 # arguments.
188 &quot;A String&quot;,
189 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700190 &quot;code&quot;: &quot;A String&quot;, # Error code in the error domain. This should correspond to
191 # a value of the enum type whose name is in domain. See
192 # the core error domain in error_domain.proto.
193 &quot;domain&quot;: &quot;A String&quot;, # Error domain. RoSy services can define their own
194 # domain and error codes. This should normally be
195 # the name of an enum type, such as: gdata.CoreErrorDomain
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700196 &quot;locationType&quot;: &quot;A String&quot;,
Bu Sun Kim65020912020-05-20 12:08:20 -0700197 &quot;location&quot;: &quot;A String&quot;, # Location of the error, as specified by the location type.
198 #
199 # If location_type is PATH, this should be a path to a field that&#x27;s
200 # relative to the request, using FieldPath notation
201 # (net/proto2/util/public/field_path.h).
202 #
203 # Examples:
204 # authenticated_user.gaia_id
205 # resource.address[2].country
Bu Sun Kim65020912020-05-20 12:08:20 -0700206 &quot;externalErrorMessage&quot;: &quot;A String&quot;, # A short explanation for the error, which can be shared outside Google.
207 #
208 # Please set domain, code and arguments whenever possible instead of this
209 # error message so that external APIs can build safe error messages
210 # themselves.
211 #
212 # External messages built in a RoSy interface will most likely refer to
213 # information and concepts that are not available externally and should not
214 # be exposed. It is safer if external APIs can understand the errors and
215 # decide what the error message should look like.
Bu Sun Kim65020912020-05-20 12:08:20 -0700216 },
217 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700218 &quot;code&quot;: &quot;A String&quot;, # Global error code. Deprecated and ignored.
219 # Set custom error codes in ErrorProto.domain and ErrorProto.code
220 # instead.
Bu Sun Kim65020912020-05-20 12:08:20 -0700221 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700222 &quot;kind&quot;: &quot;A String&quot;, # Identifies the API resource&#x27;s type. The value will be `youtube#groupItem`.
223 &quot;resource&quot;: { # The `resource` object contains information that identifies the item being
224 # added to the group.
225 &quot;kind&quot;: &quot;A String&quot;, # Identifies the type of resource being added to the group.
226 #
227 # Valid values for this property are:
228 # * `youtube#channel`
229 # * `youtube#playlist`
230 # * `youtube#video`
231 # * `youtubePartner#asset`
232 &quot;id&quot;: &quot;A String&quot;, # The channel, video, playlist, or asset ID that YouTube uses to uniquely
233 # identify the item that is being added to the group.
234 },
235 &quot;id&quot;: &quot;A String&quot;, # The ID that YouTube uses to uniquely identify the `channel`, `video`,
236 # `playlist`, or `asset` resource that is included in the group. Note that
237 # this ID refers specifically to the inclusion of that resource in a
238 # particular group and is different than the channel ID, video ID,
239 # playlist ID, or asset ID that uniquely identifies the resource itself.
240 # The `resource.id` property&#x27;s value specifies the unique channel, video,
241 # playlist, or asset ID.
242 &quot;etag&quot;: &quot;A String&quot;, # The Etag of this resource.
Bu Sun Kim65020912020-05-20 12:08:20 -0700243}
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700244
245 onBehalfOfContentOwner: string, This parameter can only be used in a properly authorized request. **Note:**
246This parameter is intended exclusively for YouTube content partners that
247own and manage many different YouTube channels.
248
Bu Sun Kim65020912020-05-20 12:08:20 -0700249The `onBehalfOfContentOwner` parameter indicates that the request&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700250authorization credentials identify a YouTube user who is acting on behalf
251of the content owner specified in the parameter value. It allows content
252owners to authenticate once and get access to all their video and channel
253data, without having to provide authentication credentials for each
254individual channel. The account that the user authenticates with must be
255linked to the specified YouTube content owner.
256 x__xgafv: string, V1 error format.
257 Allowed values
258 1 - v1 error format
259 2 - v2 error format
260
261Returns:
262 An object of the form:
263
264 { # A group item.
Bu Sun Kim65020912020-05-20 12:08:20 -0700265 &quot;groupId&quot;: &quot;A String&quot;, # The ID that YouTube uses to uniquely identify the group that contains the
266 # item.
Bu Sun Kim65020912020-05-20 12:08:20 -0700267 &quot;errors&quot;: { # Request Error information. # Apiary error details
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700268 #
269 # The presence of an error field signals that the operation
270 # has failed.
Bu Sun Kim65020912020-05-20 12:08:20 -0700271 &quot;requestId&quot;: &quot;A String&quot;, # Request identifier generated by the service, which can be
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700272 # used to identify the error in the logs
Bu Sun Kim65020912020-05-20 12:08:20 -0700273 &quot;error&quot;: [ # Specific error description and codes
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700274 { # Describes one specific error.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700275 &quot;debugInfo&quot;: &quot;A String&quot;, # Debugging information, which should not be
276 # shared externally.
277 &quot;argument&quot;: [ # Error arguments, to be used when building user-friendly error messages
278 # given the error domain and code. Different error codes require different
279 # arguments.
280 &quot;A String&quot;,
281 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700282 &quot;code&quot;: &quot;A String&quot;, # Error code in the error domain. This should correspond to
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700283 # a value of the enum type whose name is in domain. See
284 # the core error domain in error_domain.proto.
Bu Sun Kim65020912020-05-20 12:08:20 -0700285 &quot;domain&quot;: &quot;A String&quot;, # Error domain. RoSy services can define their own
286 # domain and error codes. This should normally be
287 # the name of an enum type, such as: gdata.CoreErrorDomain
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700288 &quot;locationType&quot;: &quot;A String&quot;,
Bu Sun Kim65020912020-05-20 12:08:20 -0700289 &quot;location&quot;: &quot;A String&quot;, # Location of the error, as specified by the location type.
290 #
291 # If location_type is PATH, this should be a path to a field that&#x27;s
292 # relative to the request, using FieldPath notation
293 # (net/proto2/util/public/field_path.h).
294 #
295 # Examples:
296 # authenticated_user.gaia_id
297 # resource.address[2].country
Bu Sun Kim65020912020-05-20 12:08:20 -0700298 &quot;externalErrorMessage&quot;: &quot;A String&quot;, # A short explanation for the error, which can be shared outside Google.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700299 #
300 # Please set domain, code and arguments whenever possible instead of this
301 # error message so that external APIs can build safe error messages
302 # themselves.
303 #
304 # External messages built in a RoSy interface will most likely refer to
305 # information and concepts that are not available externally and should not
306 # be exposed. It is safer if external APIs can understand the errors and
307 # decide what the error message should look like.
Bu Sun Kim65020912020-05-20 12:08:20 -0700308 },
309 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700310 &quot;code&quot;: &quot;A String&quot;, # Global error code. Deprecated and ignored.
311 # Set custom error codes in ErrorProto.domain and ErrorProto.code
312 # instead.
Bu Sun Kim65020912020-05-20 12:08:20 -0700313 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700314 &quot;kind&quot;: &quot;A String&quot;, # Identifies the API resource&#x27;s type. The value will be `youtube#groupItem`.
315 &quot;resource&quot;: { # The `resource` object contains information that identifies the item being
316 # added to the group.
317 &quot;kind&quot;: &quot;A String&quot;, # Identifies the type of resource being added to the group.
318 #
319 # Valid values for this property are:
320 # * `youtube#channel`
321 # * `youtube#playlist`
322 # * `youtube#video`
323 # * `youtubePartner#asset`
324 &quot;id&quot;: &quot;A String&quot;, # The channel, video, playlist, or asset ID that YouTube uses to uniquely
325 # identify the item that is being added to the group.
326 },
327 &quot;id&quot;: &quot;A String&quot;, # The ID that YouTube uses to uniquely identify the `channel`, `video`,
328 # `playlist`, or `asset` resource that is included in the group. Note that
329 # this ID refers specifically to the inclusion of that resource in a
330 # particular group and is different than the channel ID, video ID,
331 # playlist ID, or asset ID that uniquely identifies the resource itself.
332 # The `resource.id` property&#x27;s value specifies the unique channel, video,
333 # playlist, or asset ID.
334 &quot;etag&quot;: &quot;A String&quot;, # The Etag of this resource.
Bu Sun Kim65020912020-05-20 12:08:20 -0700335 }</pre>
336</div>
337
338<div class="method">
339 <code class="details" id="list">list(groupId=None, onBehalfOfContentOwner=None, x__xgafv=None)</code>
340 <pre>Returns a collection of group items that match the API request parameters.
341
342Args:
343 groupId: string, The `groupId` parameter specifies the unique ID of the group for which you
344want to retrieve group items.
345 onBehalfOfContentOwner: string, This parameter can only be used in a properly authorized request. **Note:**
346This parameter is intended exclusively for YouTube content partners that
347own and manage many different YouTube channels.
348
349The `onBehalfOfContentOwner` parameter indicates that the request&#x27;s
350authorization credentials identify a YouTube user who is acting on behalf
351of the content owner specified in the parameter value. It allows content
352owners to authenticate once and get access to all their video and channel
353data, without having to provide authentication credentials for each
354individual channel. The account that the user authenticates with must be
355linked to the specified YouTube content owner.
356 x__xgafv: string, V1 error format.
357 Allowed values
358 1 - v1 error format
359 2 - v2 error format
360
361Returns:
362 An object of the form:
363
364 { # Response message for GroupsService.ListGroupItems.
365 &quot;kind&quot;: &quot;A String&quot;, # Identifies the API resource&#x27;s type. The value will be
366 # `youtube#groupItemListResponse`.
367 &quot;items&quot;: [ # A list of groups that match the API request parameters. Each item in the
368 # list represents a `groupItem` resource.
369 { # A group item.
Bu Sun Kim65020912020-05-20 12:08:20 -0700370 &quot;groupId&quot;: &quot;A String&quot;, # The ID that YouTube uses to uniquely identify the group that contains the
371 # item.
Bu Sun Kim65020912020-05-20 12:08:20 -0700372 &quot;errors&quot;: { # Request Error information. # Apiary error details
373 #
374 # The presence of an error field signals that the operation
375 # has failed.
Bu Sun Kim65020912020-05-20 12:08:20 -0700376 &quot;requestId&quot;: &quot;A String&quot;, # Request identifier generated by the service, which can be
377 # used to identify the error in the logs
378 &quot;error&quot;: [ # Specific error description and codes
379 { # Describes one specific error.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700380 &quot;debugInfo&quot;: &quot;A String&quot;, # Debugging information, which should not be
381 # shared externally.
382 &quot;argument&quot;: [ # Error arguments, to be used when building user-friendly error messages
383 # given the error domain and code. Different error codes require different
384 # arguments.
385 &quot;A String&quot;,
386 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700387 &quot;code&quot;: &quot;A String&quot;, # Error code in the error domain. This should correspond to
388 # a value of the enum type whose name is in domain. See
389 # the core error domain in error_domain.proto.
390 &quot;domain&quot;: &quot;A String&quot;, # Error domain. RoSy services can define their own
391 # domain and error codes. This should normally be
392 # the name of an enum type, such as: gdata.CoreErrorDomain
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700393 &quot;locationType&quot;: &quot;A String&quot;,
Bu Sun Kim65020912020-05-20 12:08:20 -0700394 &quot;location&quot;: &quot;A String&quot;, # Location of the error, as specified by the location type.
395 #
396 # If location_type is PATH, this should be a path to a field that&#x27;s
397 # relative to the request, using FieldPath notation
398 # (net/proto2/util/public/field_path.h).
399 #
400 # Examples:
401 # authenticated_user.gaia_id
402 # resource.address[2].country
Bu Sun Kim65020912020-05-20 12:08:20 -0700403 &quot;externalErrorMessage&quot;: &quot;A String&quot;, # A short explanation for the error, which can be shared outside Google.
404 #
405 # Please set domain, code and arguments whenever possible instead of this
406 # error message so that external APIs can build safe error messages
407 # themselves.
408 #
409 # External messages built in a RoSy interface will most likely refer to
410 # information and concepts that are not available externally and should not
411 # be exposed. It is safer if external APIs can understand the errors and
412 # decide what the error message should look like.
Bu Sun Kim65020912020-05-20 12:08:20 -0700413 },
414 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700415 &quot;code&quot;: &quot;A String&quot;, # Global error code. Deprecated and ignored.
416 # Set custom error codes in ErrorProto.domain and ErrorProto.code
417 # instead.
Bu Sun Kim65020912020-05-20 12:08:20 -0700418 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700419 &quot;kind&quot;: &quot;A String&quot;, # Identifies the API resource&#x27;s type. The value will be `youtube#groupItem`.
420 &quot;resource&quot;: { # The `resource` object contains information that identifies the item being
421 # added to the group.
422 &quot;kind&quot;: &quot;A String&quot;, # Identifies the type of resource being added to the group.
423 #
424 # Valid values for this property are:
425 # * `youtube#channel`
426 # * `youtube#playlist`
427 # * `youtube#video`
428 # * `youtubePartner#asset`
429 &quot;id&quot;: &quot;A String&quot;, # The channel, video, playlist, or asset ID that YouTube uses to uniquely
430 # identify the item that is being added to the group.
431 },
432 &quot;id&quot;: &quot;A String&quot;, # The ID that YouTube uses to uniquely identify the `channel`, `video`,
433 # `playlist`, or `asset` resource that is included in the group. Note that
434 # this ID refers specifically to the inclusion of that resource in a
435 # particular group and is different than the channel ID, video ID,
436 # playlist ID, or asset ID that uniquely identifies the resource itself.
437 # The `resource.id` property&#x27;s value specifies the unique channel, video,
438 # playlist, or asset ID.
439 &quot;etag&quot;: &quot;A String&quot;, # The Etag of this resource.
Bu Sun Kim65020912020-05-20 12:08:20 -0700440 },
441 ],
442 &quot;errors&quot;: { # Request Error information. # Apiary error details
443 #
444 # The presence of an error field signals that the operation
445 # has failed.
Bu Sun Kim65020912020-05-20 12:08:20 -0700446 &quot;requestId&quot;: &quot;A String&quot;, # Request identifier generated by the service, which can be
447 # used to identify the error in the logs
448 &quot;error&quot;: [ # Specific error description and codes
449 { # Describes one specific error.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700450 &quot;debugInfo&quot;: &quot;A String&quot;, # Debugging information, which should not be
451 # shared externally.
452 &quot;argument&quot;: [ # Error arguments, to be used when building user-friendly error messages
453 # given the error domain and code. Different error codes require different
454 # arguments.
455 &quot;A String&quot;,
456 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700457 &quot;code&quot;: &quot;A String&quot;, # Error code in the error domain. This should correspond to
458 # a value of the enum type whose name is in domain. See
459 # the core error domain in error_domain.proto.
460 &quot;domain&quot;: &quot;A String&quot;, # Error domain. RoSy services can define their own
461 # domain and error codes. This should normally be
462 # the name of an enum type, such as: gdata.CoreErrorDomain
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700463 &quot;locationType&quot;: &quot;A String&quot;,
Bu Sun Kim65020912020-05-20 12:08:20 -0700464 &quot;location&quot;: &quot;A String&quot;, # Location of the error, as specified by the location type.
465 #
466 # If location_type is PATH, this should be a path to a field that&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700467 # relative to the request, using FieldPath notation
468 # (net/proto2/util/public/field_path.h).
469 #
470 # Examples:
471 # authenticated_user.gaia_id
472 # resource.address[2].country
Bu Sun Kim65020912020-05-20 12:08:20 -0700473 &quot;externalErrorMessage&quot;: &quot;A String&quot;, # A short explanation for the error, which can be shared outside Google.
474 #
475 # Please set domain, code and arguments whenever possible instead of this
476 # error message so that external APIs can build safe error messages
477 # themselves.
478 #
479 # External messages built in a RoSy interface will most likely refer to
480 # information and concepts that are not available externally and should not
481 # be exposed. It is safer if external APIs can understand the errors and
482 # decide what the error message should look like.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700483 },
484 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700485 &quot;code&quot;: &quot;A String&quot;, # Global error code. Deprecated and ignored.
486 # Set custom error codes in ErrorProto.domain and ErrorProto.code
487 # instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700488 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700489 &quot;etag&quot;: &quot;A String&quot;, # The Etag of this resource.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700490 }</pre>
491</div>
492
493</body></html>