blob: 061602722aa0494966cee0e089b466ec0eec8092 [file] [log] [blame]
John Asmuth614db982014-04-24 15:46:26 -04001<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="plusDomains_v1.html">Google+ Domains API</a> . <a href="plusDomains_v1.media.html">media</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
Jon Wayne Parrott692617a2017-01-06 09:58:29 -080078 <code><a href="#insert">insert(userId, collection, body=None, media_body=None, media_mime_type=None)</a></code></p>
John Asmuth614db982014-04-24 15:46:26 -040079<p class="firstline">Add a new media item to an album. The current upload size limitations are 36MB for a photo and 1GB for a video. Uploads do not count against quota if photos are less than 2048 pixels on their longest side or videos are less than 15 minutes in length.</p>
80<h3>Method Details</h3>
81<div class="method">
Jon Wayne Parrott692617a2017-01-06 09:58:29 -080082 <code class="details" id="insert">insert(userId, collection, body=None, media_body=None, media_mime_type=None)</code>
John Asmuth614db982014-04-24 15:46:26 -040083 <pre>Add a new media item to an album. The current upload size limitations are 36MB for a photo and 1GB for a video. Uploads do not count against quota if photos are less than 2048 pixels on their longest side or videos are less than 15 minutes in length.
84
85Args:
86 userId: string, The ID of the user to create the activity on behalf of. (required)
87 collection: string, A parameter (required)
88 Allowed values
89 cloud - Upload the media to share on Google+.
90 body: object, The request body.
91 The object takes the form of:
92
93{
94 "kind": "plus#media", # The type of resource.
95 "displayName": "A String", # The display name for this media.
96 "exif": { # Exif information of the media item.
97 "time": "A String", # The time the media was captured. Formatted as an RFC 3339 timestamp.
98 },
99 "author": { # The person who uploaded this media.
100 "url": "A String", # A link to the author's Google profile.
101 "image": { # The author's Google profile image.
102 "url": "A String", # The URL of the author's profile photo. To resize the image and crop it to a square, append the query string ?sz=x, where x is the dimension in pixels of each side.
103 },
104 "displayName": "A String", # The author's name.
105 "id": "A String", # ID of the author.
106 },
107 "url": "A String", # The URL for the page that hosts this media.
108 "mediaUrl": "A String", # The URL of this photo or video's still image.
109 "videoStatus": "A String", # The encoding status of this video. Possible values are:
110 # - "UPLOADING" - Not all the video bytes have been received.
111 # - "PENDING" - Video not yet processed.
112 # - "FAILED" - Video processing failed.
113 # - "READY" - A single video stream is playable.
114 # - "FINAL" - All video streams are playable.
115 "updated": "A String", # The time at which this media was last updated. This includes changes to media metadata. Formatted as an RFC 3339 timestamp.
116 "summary": "A String", # A description, or caption, for this media.
117 "height": 42, # The height in pixels of the original image.
118 "videoDuration": "A String", # The duration in milliseconds of this video.
119 "sizeBytes": "A String", # The size in bytes of this video.
120 "etag": "A String", # ETag of this response for caching purposes.
121 "streams": [ # The list of video streams for this video. There might be several different streams available for a single video, either Flash or MPEG, of various sizes
122 {
123 "url": "A String", # URL of the video stream.
124 "width": 42, # The width, in pixels, of the video resource.
125 "type": "A String", # MIME type of the video stream.
126 "height": 42, # The height, in pixels, of the video resource.
127 },
128 ],
129 "width": 42, # The width in pixels of the original image.
130 "published": "A String", # The time at which this media was uploaded. Formatted as an RFC 3339 timestamp.
131 "mediaCreatedTime": "A String", # The time at which this media was originally created in UTC. Formatted as an RFC 3339 timestamp that matches this example: 2010-11-25T14:30:27.655Z
132 "id": "A String", # ID of this media, which is generated by the API.
133 }
134
135 media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800136 media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
John Asmuth614db982014-04-24 15:46:26 -0400137
138Returns:
139 An object of the form:
140
141 {
142 "kind": "plus#media", # The type of resource.
143 "displayName": "A String", # The display name for this media.
144 "exif": { # Exif information of the media item.
145 "time": "A String", # The time the media was captured. Formatted as an RFC 3339 timestamp.
146 },
147 "author": { # The person who uploaded this media.
148 "url": "A String", # A link to the author's Google profile.
149 "image": { # The author's Google profile image.
150 "url": "A String", # The URL of the author's profile photo. To resize the image and crop it to a square, append the query string ?sz=x, where x is the dimension in pixels of each side.
151 },
152 "displayName": "A String", # The author's name.
153 "id": "A String", # ID of the author.
154 },
155 "url": "A String", # The URL for the page that hosts this media.
156 "mediaUrl": "A String", # The URL of this photo or video's still image.
157 "videoStatus": "A String", # The encoding status of this video. Possible values are:
158 # - "UPLOADING" - Not all the video bytes have been received.
159 # - "PENDING" - Video not yet processed.
160 # - "FAILED" - Video processing failed.
161 # - "READY" - A single video stream is playable.
162 # - "FINAL" - All video streams are playable.
163 "updated": "A String", # The time at which this media was last updated. This includes changes to media metadata. Formatted as an RFC 3339 timestamp.
164 "summary": "A String", # A description, or caption, for this media.
165 "height": 42, # The height in pixels of the original image.
166 "videoDuration": "A String", # The duration in milliseconds of this video.
167 "sizeBytes": "A String", # The size in bytes of this video.
168 "etag": "A String", # ETag of this response for caching purposes.
169 "streams": [ # The list of video streams for this video. There might be several different streams available for a single video, either Flash or MPEG, of various sizes
170 {
171 "url": "A String", # URL of the video stream.
172 "width": 42, # The width, in pixels, of the video resource.
173 "type": "A String", # MIME type of the video stream.
174 "height": 42, # The height, in pixels, of the video resource.
175 },
176 ],
177 "width": 42, # The width in pixels of the original image.
178 "published": "A String", # The time at which this media was uploaded. Formatted as an RFC 3339 timestamp.
179 "mediaCreatedTime": "A String", # The time at which this media was originally created in UTC. Formatted as an RFC 3339 timestamp that matches this example: 2010-11-25T14:30:27.655Z
180 "id": "A String", # ID of this media, which is generated by the API.
181 }</pre>
182</div>
183
184</body></html>