• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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
75<h1><a href="playmoviespartner_v1.html">Google Play Movies Partner API</a> . <a href="playmoviespartner_v1.accounts.html">accounts</a> . <a href="playmoviespartner_v1.accounts.avails.html">avails</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78  <code><a href="#get">get(accountId, availId, x__xgafv=None)</a></code></p>
79<p class="firstline">Get an Avail given its avail group id and avail id.</p>
80<p class="toc_element">
81  <code><a href="#list">list(accountId, pphNames=None, pageSize=None, territories=None, altIds=None, x__xgafv=None, title=None, studioNames=None, pageToken=None, videoIds=None, altId=None)</a></code></p>
82<p class="firstline">List Avails owned or managed by the partner.</p>
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">
88    <code class="details" id="get">get(accountId, availId, x__xgafv=None)</code>
89  <pre>Get an Avail given its avail group id and avail id.
90
91Args:
92  accountId: string, REQUIRED. See _General rules_ for more information about this field. (required)
93  availId: string, REQUIRED. Avail ID. (required)
94  x__xgafv: string, V1 error format.
95    Allowed values
96      1 - v1 error format
97      2 - v2 error format
98
99Returns:
100  An object of the form:
101
102    { # An Avail describes the Availability Window of a specific Edit in a given
103      # country, which means the period Google is allowed to sell or rent the Edit.
104      #
105      # Avails are exposed in EMA format Version 1.6b (available at
106      # http://www.movielabs.com/md/avails/)
107      #
108      # Studios can see the Avails for the Titles they own.
109      # Post-production houses cannot see any Avails.
110    "pphNames": [ # Name of the post-production houses that manage the Avail.
111        # Not part of EMA Specs.
112      "A String",
113    ],
114    "licenseType": "A String", # Type of transaction.
115    "encodeId": "A String", # Manifestation Identifier. This should be the Manifestation
116        # Level EIDR.
117        # Example: "10.2340/1489-49A2-3956-4B2D-FE16-7"
118    "captionIncluded": True or False, # Communicating if caption file will be delivered.
119    "releaseDate": "A String", # Release date of the Title in earliest released territory.
120        # Typically it is just the year, but it is free-form as per EMA spec.
121        # Examples: "1979", "Oct 2014"
122    "episodeAltId": "A String", # Other identifier referring to the episode, as defined by partner.
123        # Only available on TV avails.
124        # Example: "rs_googlers_s1_3".
125    "episodeTitleInternalAlias": "A String", # OPTIONAL.TV Only. Title used by involved parties to refer to this episode.
126        # Only available on TV Avails.
127        # Example: "Coding at Google".
128    "episodeNumber": "A String", # The number assigned to the episode within a season.
129        # Only available on TV Avails.
130        # Example: "3".
131    "end": "A String", # End of term in YYYY-MM-DD format in the timezone of the country
132        # of the Avail.
133        # "Open" if no end date is available.
134        # Example: "2019-02-17"
135    "altId": "A String", # Other identifier referring to the Edit, as defined by partner.
136        # Example: "GOOGLER_2006"
137    "ratingSystem": "A String", # Rating system applied to the version of title within territory
138        # of Avail.
139        # Rating systems should be formatted as per
140        # [EMA ratings spec](http://www.movielabs.com/md/ratings/)
141        # Example: "MPAA"
142    "start": "A String", # Start of term in YYYY-MM-DD format in the timezone of the
143        # country of the Avail.
144        # Example: "2013-05-14".
145    "titleInternalAlias": "A String", # Title used by involved parties to refer to this content.
146        # Example: "Googlers, The".
147        # Only available on Movie Avails.
148    "seasonTitleInternalAlias": "A String", # Title used by involved parties to refer to this season.
149        # Only available on TV Avails.
150        # Example: "Googlers, The".
151    "territory": "A String", # ISO 3166-1 alpha-2 country code for the country or territory
152        # of this Avail.
153        # For Avails, we use Territory in lieu of Country to comply with
154        # EMA specifications.
155        # But please note that Territory and Country identify the same thing.
156        # Example: "US".
157    "productId": "A String", # Edit Identifier. This should be the Edit Level EIDR.
158        # Example: "10.2340/1489-49A2-3956-4B2D-FE16-6"
159    "storeLanguage": "A String", # Spoken language of the intended audience.
160        # Language shall be encoded in accordance with RFC 5646.
161        # Example: "fr".
162    "seasonNumber": "A String", # The number assigned to the season within a series.
163        # Only available on TV Avails.
164        # Example: "1".
165    "availId": "A String", # ID internally generated by Google to uniquely identify an Avail.
166        # Not part of EMA Specs.
167    "formatProfile": "A String", # Indicates the format profile covered by the transaction.
168    "priceValue": "A String", # Value to be applied to the pricing type.
169        # Example: "4" or "2.99"
170    "videoId": "A String", # Google-generated ID identifying the video linked to this Avail, once
171        # delivered.
172        # Not part of EMA Specs.
173        # Example: 'gtry456_xc'
174    "captionExemption": "A String", # Communicating an exempt category as defined by FCC regulations.
175        # It is not required for non-US Avails.
176        # Example: "1"
177    "ratingReason": "A String", # Value representing the rating reason.
178        # Rating reasons should be formatted as per
179        # [EMA ratings spec](http://www.movielabs.com/md/ratings/)
180        # and comma-separated for inclusion of multiple reasons.
181        # Example: "L, S, V"
182    "workType": "A String", # Work type as enumerated in EMA.
183    "displayName": "A String", # The name of the studio that owns the Edit referred in the Avail.
184        # This is the equivalent of `studio_name` in other resources, but it follows
185        # the EMA nomenclature.
186        # Example: "Google Films".
187    "seasonAltId": "A String", # Other identifier referring to the season, as defined by partner.
188        # Only available on TV avails.
189        # Example: "rs_googlers_s1".
190    "contentId": "A String", # Title Identifier. This should be the Title Level EIDR.
191        # Example: "10.5240/1489-49A2-3956-4B2D-FE16-5".
192    "seriesAltId": "A String", # Other identifier referring to the series, as defined by partner.
193        # Only available on TV avails.
194        # Example: "rs_googlers".
195    "ratingValue": "A String", # Value representing the rating.
196        # Ratings should be formatted as per http://www.movielabs.com/md/ratings/
197        # Example: "PG"
198    "seriesTitleInternalAlias": "A String", # Title used by involved parties to refer to this series.
199        # Only available on TV Avails.
200        # Example: "Googlers, The".
201    "suppressionLiftDate": "A String", # First date an Edit could be publically announced as becoming
202        # available at a specific future date in territory of Avail.
203        # *Not* the Avail start date or pre-order start date.
204        # Format is YYYY-MM-DD.
205        # Only available for pre-orders.
206        # Example: "2012-12-10"
207    "priceType": "A String", # Type of pricing that should be applied to this Avail
208        # based on how the partner classify them.
209        # Example: "Tier", "WSP", "SRP", or "Category".
210  }</pre>
211</div>
212
213<div class="method">
214    <code class="details" id="list">list(accountId, pphNames=None, pageSize=None, territories=None, altIds=None, x__xgafv=None, title=None, studioNames=None, pageToken=None, videoIds=None, altId=None)</code>
215  <pre>List Avails owned or managed by the partner.
216
217See _Authentication and Authorization rules_ and
218_List methods rules_ for more information about this method.
219
220Args:
221  accountId: string, REQUIRED. See _General rules_ for more information about this field. (required)
222  pphNames: string, See _List methods rules_ for info about this field. (repeated)
223  pageSize: integer, See _List methods rules_ for info about this field.
224  territories: string, Filter Avails that match (case-insensitive) any of the given country codes,
225using the "ISO 3166-1 alpha-2" format (examples: "US", "us", "Us"). (repeated)
226  altIds: string, Filter Avails that match (case-insensitive) any of the given partner-specific custom ids. (repeated)
227  x__xgafv: string, V1 error format.
228    Allowed values
229      1 - v1 error format
230      2 - v2 error format
231  title: string, Filter that matches Avails with a `title_internal_alias`,
232`series_title_internal_alias`, `season_title_internal_alias`,
233or `episode_title_internal_alias` that contains the given
234case-insensitive title.
235  studioNames: string, See _List methods rules_ for info about this field. (repeated)
236  pageToken: string, See _List methods rules_ for info about this field.
237  videoIds: string, Filter Avails that match any of the given `video_id`s. (repeated)
238  altId: string, Filter Avails that match a case-insensitive, partner-specific custom id.
239NOTE: this field is deprecated and will be removed on V2; `alt_ids`
240should be used instead.
241
242Returns:
243  An object of the form:
244
245    { # Response to the 'ListAvails' method.
246    "nextPageToken": "A String", # See _List methods rules_ for info about this field.
247    "totalSize": 42, # See _List methods rules_ for more information about this field.
248    "avails": [ # List of Avails that match the request criteria.
249      { # An Avail describes the Availability Window of a specific Edit in a given
250          # country, which means the period Google is allowed to sell or rent the Edit.
251          #
252          # Avails are exposed in EMA format Version 1.6b (available at
253          # http://www.movielabs.com/md/avails/)
254          #
255          # Studios can see the Avails for the Titles they own.
256          # Post-production houses cannot see any Avails.
257        "pphNames": [ # Name of the post-production houses that manage the Avail.
258            # Not part of EMA Specs.
259          "A String",
260        ],
261        "licenseType": "A String", # Type of transaction.
262        "encodeId": "A String", # Manifestation Identifier. This should be the Manifestation
263            # Level EIDR.
264            # Example: "10.2340/1489-49A2-3956-4B2D-FE16-7"
265        "captionIncluded": True or False, # Communicating if caption file will be delivered.
266        "releaseDate": "A String", # Release date of the Title in earliest released territory.
267            # Typically it is just the year, but it is free-form as per EMA spec.
268            # Examples: "1979", "Oct 2014"
269        "episodeAltId": "A String", # Other identifier referring to the episode, as defined by partner.
270            # Only available on TV avails.
271            # Example: "rs_googlers_s1_3".
272        "episodeTitleInternalAlias": "A String", # OPTIONAL.TV Only. Title used by involved parties to refer to this episode.
273            # Only available on TV Avails.
274            # Example: "Coding at Google".
275        "episodeNumber": "A String", # The number assigned to the episode within a season.
276            # Only available on TV Avails.
277            # Example: "3".
278        "end": "A String", # End of term in YYYY-MM-DD format in the timezone of the country
279            # of the Avail.
280            # "Open" if no end date is available.
281            # Example: "2019-02-17"
282        "altId": "A String", # Other identifier referring to the Edit, as defined by partner.
283            # Example: "GOOGLER_2006"
284        "ratingSystem": "A String", # Rating system applied to the version of title within territory
285            # of Avail.
286            # Rating systems should be formatted as per
287            # [EMA ratings spec](http://www.movielabs.com/md/ratings/)
288            # Example: "MPAA"
289        "start": "A String", # Start of term in YYYY-MM-DD format in the timezone of the
290            # country of the Avail.
291            # Example: "2013-05-14".
292        "titleInternalAlias": "A String", # Title used by involved parties to refer to this content.
293            # Example: "Googlers, The".
294            # Only available on Movie Avails.
295        "seasonTitleInternalAlias": "A String", # Title used by involved parties to refer to this season.
296            # Only available on TV Avails.
297            # Example: "Googlers, The".
298        "territory": "A String", # ISO 3166-1 alpha-2 country code for the country or territory
299            # of this Avail.
300            # For Avails, we use Territory in lieu of Country to comply with
301            # EMA specifications.
302            # But please note that Territory and Country identify the same thing.
303            # Example: "US".
304        "productId": "A String", # Edit Identifier. This should be the Edit Level EIDR.
305            # Example: "10.2340/1489-49A2-3956-4B2D-FE16-6"
306        "storeLanguage": "A String", # Spoken language of the intended audience.
307            # Language shall be encoded in accordance with RFC 5646.
308            # Example: "fr".
309        "seasonNumber": "A String", # The number assigned to the season within a series.
310            # Only available on TV Avails.
311            # Example: "1".
312        "availId": "A String", # ID internally generated by Google to uniquely identify an Avail.
313            # Not part of EMA Specs.
314        "formatProfile": "A String", # Indicates the format profile covered by the transaction.
315        "priceValue": "A String", # Value to be applied to the pricing type.
316            # Example: "4" or "2.99"
317        "videoId": "A String", # Google-generated ID identifying the video linked to this Avail, once
318            # delivered.
319            # Not part of EMA Specs.
320            # Example: 'gtry456_xc'
321        "captionExemption": "A String", # Communicating an exempt category as defined by FCC regulations.
322            # It is not required for non-US Avails.
323            # Example: "1"
324        "ratingReason": "A String", # Value representing the rating reason.
325            # Rating reasons should be formatted as per
326            # [EMA ratings spec](http://www.movielabs.com/md/ratings/)
327            # and comma-separated for inclusion of multiple reasons.
328            # Example: "L, S, V"
329        "workType": "A String", # Work type as enumerated in EMA.
330        "displayName": "A String", # The name of the studio that owns the Edit referred in the Avail.
331            # This is the equivalent of `studio_name` in other resources, but it follows
332            # the EMA nomenclature.
333            # Example: "Google Films".
334        "seasonAltId": "A String", # Other identifier referring to the season, as defined by partner.
335            # Only available on TV avails.
336            # Example: "rs_googlers_s1".
337        "contentId": "A String", # Title Identifier. This should be the Title Level EIDR.
338            # Example: "10.5240/1489-49A2-3956-4B2D-FE16-5".
339        "seriesAltId": "A String", # Other identifier referring to the series, as defined by partner.
340            # Only available on TV avails.
341            # Example: "rs_googlers".
342        "ratingValue": "A String", # Value representing the rating.
343            # Ratings should be formatted as per http://www.movielabs.com/md/ratings/
344            # Example: "PG"
345        "seriesTitleInternalAlias": "A String", # Title used by involved parties to refer to this series.
346            # Only available on TV Avails.
347            # Example: "Googlers, The".
348        "suppressionLiftDate": "A String", # First date an Edit could be publically announced as becoming
349            # available at a specific future date in territory of Avail.
350            # *Not* the Avail start date or pre-order start date.
351            # Format is YYYY-MM-DD.
352            # Only available for pre-orders.
353            # Example: "2012-12-10"
354        "priceType": "A String", # Type of pricing that should be applied to this Avail
355            # based on how the partner classify them.
356            # Example: "Tier", "WSP", "SRP", or "Category".
357      },
358    ],
359  }</pre>
360</div>
361
362<div class="method">
363    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
364  <pre>Retrieves the next page of results.
365
366Args:
367  previous_request: The request for the previous page. (required)
368  previous_response: The response from the request for the previous page. (required)
369
370Returns:
371  A request object that you can call 'execute()' on to request the next
372  page. Returns None if there are no more items in the collection.
373    </pre>
374</div>
375
376</body></html>