Google Play Game Services . snapshotsExtended

Instance Methods

close()

Close httplib2 connections.

resolveSnapshotHead(snapshotName, body=None, x__xgafv=None)

Resolves any potential conflicts according to the resolution policy specified in the request and returns the snapshot head after the resolution.

Method Details

close()
Close httplib2 connections.
resolveSnapshotHead(snapshotName, body=None, x__xgafv=None)
Resolves any potential conflicts according to the resolution policy specified in the request and returns the snapshot head after the resolution.

Args:
  snapshotName: string, Required. Name of the snapshot. (required)
  body: object, The request body.
    The object takes the form of:

{ # Request for ResolveSnapshotHead RPC.
  "maxConflictsPerSnapshot": 42, # The maximum number of SnapshotRevision resources for `conflictingRevisions` to return per SnapshotExtended resource in the response. For any response, the actual number of resources returned may be less than specified by `maxConflictsPerSnapshot`. The value provided should be greater or equal to 0. If no value is provided, the server will use a sensible default.
  "resolutionPolicy": "A String", # Required. The automatic resolution policy. All conflicts are resolved in chronological order, starting from the/ least recent. If the comparison metric is equal for the tentative head and the conflict, the head wins.
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response for ResolveSnapshotHead RPC.
  "snapshot": { # A snapshot represents a saved game state referred to using the developer-provided snapshot_name. The set of attributes and binary data for a specific state is called a revision. Each revision is itself immutable, and referred to by a snapshot revision id. At any time, a snapshot has a "head" revision, and updates are made against that revision. If a snapshot update is received that isn't against the current head revision, then instead of changing the head revision it will result in a conflicting revision that must be specifically resolved. # The state of the snapshot.
    "conflictingRevisions": [ # A list of conflicting revisions. Only set if explicitly requested (e.g. using a field mask or a request flag), or if the RPC guarantees that this field is set. The conflicting revisions are sorted chronologically by their server creation time (oldest first). If there are too many conflicting revisions to return all of them in a single request this will only contain the first batch. In such case, the presented conflicting revisions must be resolved first in order to fetch the next batch.
      { # A Snapshot revision resource. Snapshot revisions are immutable.
        "blob": { # Identifies a snapshot data resource. The data is provided by the game. # Reference to the game provided blob for this revision.
          "contentHash": "A String", # Output only. Hash-like weak identifier of the uploaded blob bytes, consistent per player per application. The content hash for a given resource will not change if the binary data hasn't changed. Except in very rare circumstances, the content_hash for matching binary data will be the same within a given player and application.
          "downloadUrl": "A String", # Output only. A URL that the client can use to download the blob. May vary across requests, and only guaranteed to be valid for a short time after it is returned.
          "resourceId": "A String", # The ID of the blob resource. It's guaranteed that if two IDs are equal then the contents are equal as well. It's not guaranteed that two identical blobs coming from separate uploads have the same resource ID. The resource ID can only be used within the application, user and resource type it was originally returned for. For example, it's not possible to use SnapshotDataResource's resource ID as the resource_id of a SnapshotCoverImageResource, even if the blob is a valid image file.
          "size": "A String", # Output only. Size of the saved game blob in bytes.
        },
        "coverImage": { # Identifies a snapshot cover image resource. The image is provided by the game. # Reference to the cover image for this revision.
          "contentHash": "A String", # Output only. Hash-like weak identifier of the uploaded image bytes, consistent per player per application. The content hash for a given resource will not change if the binary data hasn't changed. Except in very rare circumstances, the content_hash for matching binary data will be the same within a given player and application.
          "downloadUrl": "A String", # Output only. A URL the client can use to download the image. May vary across requests, and only guaranteed to be valid for a short time after it is returned.
          "height": 42, # The height of the image in pixels.
          "mimeType": "A String", # Output only. The MIME type of the image.
          "resourceId": "A String", # The ID of the image resource. It's guaranteed that if two IDs are equal then the contents are equal as well. It's not guaranteed that two identical blobs coming from separate uploads have the same ID. The resource ID can only be used within the application, user and resource type it was originally returned for. For example, it's not possible to use SnapshotDataResource's resource ID as the resource_id of a SnapshotCoverImageResource, even if the blob is a valid image file.
          "width": 42, # The width of the image in pixels.
        },
        "id": "A String", # Output only. A server generated identifier of the snapshot revision.
        "metadata": { # Metadata about a snapshot revision. Snapshot metadata is immutable - a metadata change corresponds to a new snapshot revision. # Metadata for this snapshot revision.
          "description": "A String", # The description of this snapshot.
          "deviceName": "A String", # The device that created the current revision.
          "gameplayDuration": "A String", # The duration associated with this snapshot. Values with sub-millisecond precision can be rounded or trimmed to the closest millisecond.
          "lastModifyTime": "A String", # The timestamp of the last modification to this snapshot as provided by the client. Values with sub-millisecond precision can be rounded or trimmed to the closest millisecond.
          "progressValue": "A String", # The progress value (64-bit integer set by developer) associated with this snapshot.
        },
      },
    ],
    "hasConflictingRevisions": True or False, # An indicator whether the snapshot has any conflicting revisions or not. Always set.
    "headRevision": { # A Snapshot revision resource. Snapshot revisions are immutable. # The current head revision (the canonical revision as understood by the server).
      "blob": { # Identifies a snapshot data resource. The data is provided by the game. # Reference to the game provided blob for this revision.
        "contentHash": "A String", # Output only. Hash-like weak identifier of the uploaded blob bytes, consistent per player per application. The content hash for a given resource will not change if the binary data hasn't changed. Except in very rare circumstances, the content_hash for matching binary data will be the same within a given player and application.
        "downloadUrl": "A String", # Output only. A URL that the client can use to download the blob. May vary across requests, and only guaranteed to be valid for a short time after it is returned.
        "resourceId": "A String", # The ID of the blob resource. It's guaranteed that if two IDs are equal then the contents are equal as well. It's not guaranteed that two identical blobs coming from separate uploads have the same resource ID. The resource ID can only be used within the application, user and resource type it was originally returned for. For example, it's not possible to use SnapshotDataResource's resource ID as the resource_id of a SnapshotCoverImageResource, even if the blob is a valid image file.
        "size": "A String", # Output only. Size of the saved game blob in bytes.
      },
      "coverImage": { # Identifies a snapshot cover image resource. The image is provided by the game. # Reference to the cover image for this revision.
        "contentHash": "A String", # Output only. Hash-like weak identifier of the uploaded image bytes, consistent per player per application. The content hash for a given resource will not change if the binary data hasn't changed. Except in very rare circumstances, the content_hash for matching binary data will be the same within a given player and application.
        "downloadUrl": "A String", # Output only. A URL the client can use to download the image. May vary across requests, and only guaranteed to be valid for a short time after it is returned.
        "height": 42, # The height of the image in pixels.
        "mimeType": "A String", # Output only. The MIME type of the image.
        "resourceId": "A String", # The ID of the image resource. It's guaranteed that if two IDs are equal then the contents are equal as well. It's not guaranteed that two identical blobs coming from separate uploads have the same ID. The resource ID can only be used within the application, user and resource type it was originally returned for. For example, it's not possible to use SnapshotDataResource's resource ID as the resource_id of a SnapshotCoverImageResource, even if the blob is a valid image file.
        "width": 42, # The width of the image in pixels.
      },
      "id": "A String", # Output only. A server generated identifier of the snapshot revision.
      "metadata": { # Metadata about a snapshot revision. Snapshot metadata is immutable - a metadata change corresponds to a new snapshot revision. # Metadata for this snapshot revision.
        "description": "A String", # The description of this snapshot.
        "deviceName": "A String", # The device that created the current revision.
        "gameplayDuration": "A String", # The duration associated with this snapshot. Values with sub-millisecond precision can be rounded or trimmed to the closest millisecond.
        "lastModifyTime": "A String", # The timestamp of the last modification to this snapshot as provided by the client. Values with sub-millisecond precision can be rounded or trimmed to the closest millisecond.
        "progressValue": "A String", # The progress value (64-bit integer set by developer) associated with this snapshot.
      },
    },
    "snapshotName": "A String", # An identifier of the snapshot, developer-specified. It must match the pattern [0-9a-zA-Z-._~]{1,100}.
  },
}