Shut down. See https://developers.google.com/+/api-shutdown for more details.

Scopes

You will need authorization for at least one of the following scopes to make a valid call:

  • https://www.googleapis.com/auth/plus.login
  • https://www.googleapis.com/auth/plus.me
  • https://www.googleapis.com/auth/plus.media.upload

If unset, the scope for this method defaults to https://www.googleapis.com/auth/plus.login. You can set the scope for this method like this: plusdomains1 --scope <scope> media insert ...

Required Scalar Arguments

  • <user-id> (string)
    • The ID of the user to create the activity on behalf of.
  • <collection> (string)
    • No description provided.

Required Request Value

The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure. In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely.

For example, a structure like this:

Media:
  author:
    display-name: string
    id: string
    image:
      url: string
    url: string
  display-name: string
  etag: string
  exif:
    time: string
  height: integer
  id: string
  kind: string
  media-created-time: string
  media-url: string
  published: string
  size-bytes: string
  summary: string
  updated: string
  url: string
  video-duration: string
  video-status: string
  width: integer

can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time.

  • -r .author display-name=et
    • The author's name.
  • id=magna
    • ID of the author.

  • image url=no

    • 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.

  • .. url=ipsum

    • A link to the author's Google profile.

  • .. display-name=voluptua.

    • The display name for this media.
  • etag=at
    • ETag of this response for caching purposes.

  • exif time=sanctus

    • The time the media was captured. Formatted as an RFC 3339 timestamp.

  • .. height=21

    • The height in pixels of the original image.
  • id=amet.
    • ID of this media, which is generated by the API.
  • kind=takimata
    • The type of resource.
  • media-created-time=amet.
    • 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
  • media-url=duo
    • The URL of this photo or video's still image.
  • published=ipsum
    • The time at which this media was uploaded. Formatted as an RFC 3339 timestamp.
  • size-bytes=gubergren
    • The size in bytes of this video.
  • summary=lorem
    • A description, or caption, for this media.
  • updated=gubergren
    • The time at which this media was last updated. This includes changes to media metadata. Formatted as an RFC 3339 timestamp.
  • url=eos
    • The URL for the page that hosts this media.
  • video-duration=dolor
    • The duration in milliseconds of this video.
  • video-status=ea
    • 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.
  • width=46
    • The width in pixels of the original image.

About Cursors

The cursor position is key to comfortably set complex nested structures. The following rules apply:

  • The cursor position is always set relative to the current one, unless the field name starts with the . character. Fields can be nested such as in -r f.s.o .
  • The cursor position is set relative to the top-level structure if it starts with ., e.g. -r .s.s
  • You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify -r struct.sub_struct=bar.
  • You can move the cursor one level up by using ... Each additional . moves it up one additional level. E.g. ... would go three levels up.

Required Upload Flags

This method supports the upload of data, which requires all of the following flags to be set:

  • -u simple
    • simple - Upload media all at once.
  • -f file
    • Path to file to upload. It must be seekable.

The following flag may be set:

  • -m mime
    • the mime type, like 'application/octet-stream', which is the default

Optional Output Flags

The method's return value a JSON encoded structure, which will be written to standard output by default.

  • -o out
    • out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.

Optional General Properties

The following properties can configure any call, and are not specific to this method.

  • -p alt=string

    • Data format for the response.

  • -p fields=string

    • Selector specifying which fields to include in a partial response.

  • -p key=string

    • API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.

  • -p oauth-token=string

    • OAuth 2.0 token for the current user.

  • -p pretty-print=boolean

    • Returns response with indentations and line breaks.

  • -p quota-user=string

    • An opaque string that represents a user for quota purposes. Must not exceed 40 characters.

  • -p user-ip=string

    • Deprecated. Please use quotaUser instead.