# Google+ Domains API . media

## Instance Methods

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.

### Method Details

`insert(userId, collection, body=None, media_body=None)`

    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.

    Args:
      userId: string, The ID of the user to create the activity on behalf of. (required)
      collection: string, A parameter (required)
        Allowed values
          cloud - Upload the media to share on Google+.
      body: object, The request body.
        The object takes the form of:

    {
        "kind": "plus#media", # The type of resource.
        "displayName": "A String", # The display name for this media.
        "exif": { # Exif information of the media item.
          "time": "A String", # The time the media was captured. Formatted as an RFC 3339 timestamp.
        },
        "author": { # The person who uploaded this media.
          "url": "A String", # A link to the author's Google profile.
          "image": { # The author's Google profile image.
            "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.
          },
          "displayName": "A String", # The author's name.
          "id": "A String", # ID of the author.
        },
        "url": "A String", # The URL for the page that hosts this media.
        "mediaUrl": "A String", # The URL of this photo or video's still image.
        "videoStatus": "A String", # The encoding status of this video. Possible values are:
            # - "UPLOADING" - Not all the video bytes have been received.
            # - "PENDING" - Video not yet processed.
            # - "FAILED" - Video processing failed.
            # - "READY" - A single video stream is playable.
            # - "FINAL" - All video streams are playable.
        "updated": "A String", # The time at which this media was last updated. This includes changes to media metadata. Formatted as an RFC 3339 timestamp.
        "summary": "A String", # A description, or caption, for this media.
        "height": 42, # The height in pixels of the original image.
        "videoDuration": "A String", # The duration in milliseconds of this video.
        "sizeBytes": "A String", # The size in bytes of this video.
        "etag": "A String", # ETag of this response for caching purposes.
        "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
          {
            "url": "A String", # URL of the video stream.
            "width": 42, # The width, in pixels, of the video resource.
            "type": "A String", # MIME type of the video stream.
            "height": 42, # The height, in pixels, of the video resource.
          },
        ],
        "width": 42, # The width in pixels of the original image.
        "published": "A String", # The time at which this media was uploaded. Formatted as an RFC 3339 timestamp.
        "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
        "id": "A String", # ID of this media, which is generated by the API.
      }

      media_body: string, The filename of the media request body, or an instance of a MediaUpload object.

    Returns:
      An object of the form:

        {
          "kind": "plus#media", # The type of resource.
          "displayName": "A String", # The display name for this media.
          "exif": { # Exif information of the media item.
            "time": "A String", # The time the media was captured. Formatted as an RFC 3339 timestamp.
          },
          "author": { # The person who uploaded this media.
            "url": "A String", # A link to the author's Google profile.
            "image": { # The author's Google profile image.
              "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.
            },
            "displayName": "A String", # The author's name.
            "id": "A String", # ID of the author.
          },
          "url": "A String", # The URL for the page that hosts this media.
          "mediaUrl": "A String", # The URL of this photo or video's still image.
          "videoStatus": "A String", # The encoding status of this video. Possible values are:
              # - "UPLOADING" - Not all the video bytes have been received.
              # - "PENDING" - Video not yet processed.
              # - "FAILED" - Video processing failed.
              # - "READY" - A single video stream is playable.
              # - "FINAL" - All video streams are playable.
          "updated": "A String", # The time at which this media was last updated. This includes changes to media metadata. Formatted as an RFC 3339 timestamp.
          "summary": "A String", # A description, or caption, for this media.
          "height": 42, # The height in pixels of the original image.
          "videoDuration": "A String", # The duration in milliseconds of this video.
          "sizeBytes": "A String", # The size in bytes of this video.
          "etag": "A String", # ETag of this response for caching purposes.
          "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
            {
              "url": "A String", # URL of the video stream.
              "width": 42, # The width, in pixels, of the video resource.
              "type": "A String", # MIME type of the video stream.
              "height": 42, # The height, in pixels, of the video resource.
            },
          ],
          "width": 42, # The width in pixels of the original image.
          "published": "A String", # The time at which this media was uploaded. Formatted as an RFC 3339 timestamp.
          "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
          "id": "A String", # ID of this media, which is generated by the API.
        }