# Google Play Game Services API . snapshots

## Instance Methods

Retrieves the metadata for a given snapshot ID.

Retrieves a list of snapshots created by your application for the player corresponding to the player ID.

Retrieves the next page of results.

### Method Details

`get(snapshotId, language=None, consistencyToken=None)`

    Retrieves the metadata for a given snapshot ID.

    Args:
      snapshotId: string, The ID of the snapshot. (required)
      language: string, The preferred language to use for strings returned by this method.
      consistencyToken: string, The last-seen mutation timestamp.

    Returns:
      An object of the form:

        { # This is a JSON template for an snapshot object.
        "kind": "games#snapshot", # Uniquely identifies the type of this resource. Value is always the fixed string games#snapshot.
        "description": "A String", # The description of this snapshot.
        "title": "A String", # The title of this snapshot.
        "coverImage": { # This is a JSON template for an image of a snapshot. # The cover image of this snapshot. May be absent if there is no image.
          "url": "A String", # The URL of the image. This URL may be invalidated at any time and should not be cached.
          "width": 42, # The width of the image.
          "kind": "games#snapshotImage", # Uniquely identifies the type of this resource. Value is always the fixed string games#snapshotImage.
          "mime_type": "A String", # The MIME type of the image.
          "height": 42, # The height of the image.
        },
        "lastModifiedMillis": "A String", # The timestamp (in millis since Unix epoch) of the last modification to this snapshot.
        "progressValue": "A String", # The progress value (64-bit integer set by developer) associated with this snapshot.
        "driveId": "A String", # The ID of the file underlying this snapshot in the Drive API. Only present if the snapshot is a view on a Drive file and the file is owned by the caller.
        "durationMillis": "A String", # The duration associated with this snapshot, in millis.
        "uniqueName": "A String", # The unique name provided when the snapshot was created.
        "type": "A String", # The type of this snapshot.
            # Possible values are:
            # - "SAVE_GAME" - A snapshot representing a save game.
        "id": "A String", # The ID of the snapshot.
      }

`list(playerId, language=None, pageToken=None, maxResults=None, consistencyToken=None)`

    Retrieves a list of snapshots created by your application for the player corresponding to the player ID.

    Args:
      playerId: string, A player ID. A value of me may be used in place of the authenticated player's ID. (required)
      language: string, The preferred language to use for strings returned by this method.
      pageToken: string, The token returned by the previous request.
      maxResults: integer, The maximum number of snapshot resources to return in the response, used for paging. For any response, the actual number of snapshot resources returned may be less than the specified maxResults.
      consistencyToken: string, The last-seen mutation timestamp.

    Returns:
      An object of the form:

        { # This is a JSON template for a list of snapshot objects.
        "nextPageToken": "A String", # Token corresponding to the next page of results. If there are no more results, the token is omitted.
        "items": [ # The snapshots.
          { # This is a JSON template for an snapshot object.
            "kind": "games#snapshot", # Uniquely identifies the type of this resource. Value is always the fixed string games#snapshot.
            "description": "A String", # The description of this snapshot.
            "title": "A String", # The title of this snapshot.
            "coverImage": { # This is a JSON template for an image of a snapshot. # The cover image of this snapshot. May be absent if there is no image.
              "url": "A String", # The URL of the image. This URL may be invalidated at any time and should not be cached.
              "width": 42, # The width of the image.
              "kind": "games#snapshotImage", # Uniquely identifies the type of this resource. Value is always the fixed string games#snapshotImage.
              "mime_type": "A String", # The MIME type of the image.
              "height": 42, # The height of the image.
            },
            "lastModifiedMillis": "A String", # The timestamp (in millis since Unix epoch) of the last modification to this snapshot.
            "progressValue": "A String", # The progress value (64-bit integer set by developer) associated with this snapshot.
            "driveId": "A String", # The ID of the file underlying this snapshot in the Drive API. Only present if the snapshot is a view on a Drive file and the file is owned by the caller.
            "durationMillis": "A String", # The duration associated with this snapshot, in millis.
            "uniqueName": "A String", # The unique name provided when the snapshot was created.
            "type": "A String", # The type of this snapshot.
                # Possible values are:
                # - "SAVE_GAME" - A snapshot representing a save game.
            "id": "A String", # The ID of the snapshot.
          },
        ],
        "kind": "games#snapshotListResponse", # Uniquely identifies the type of this resource. Value is always the fixed string games#snapshotListResponse.
      }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.