Google Play Android Developer API . reviews

Instance Methods

get(packageName, reviewId, translationLanguage=None, x__xgafv=None)

Gets a single review.

list(packageName, maxResults=None, startIndex=None, translationLanguage=None, token=None, x__xgafv=None)

Lists all reviews.

reply(packageName, reviewId, body=None, x__xgafv=None)

Replies to a single review, or updates an existing reply.

Method Details

get(packageName, reviewId, translationLanguage=None, x__xgafv=None)
Gets a single review.

Args:
  packageName: string, Package name of the app. (required)
  reviewId: string, Unique identifier for a review. (required)
  translationLanguage: string, Language localization code.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Android app review.
    "comments": [ # A repeated field containing comments for the review.
      { # An entry of conversation between user and developer.
        "developerComment": { # Developer entry from conversation between user and developer. # A comment from a developer.
          "lastModified": { # A Timestamp represents a point in time independent of any time zone or local # The last time at which this comment was updated.
              # calendar, encoded as a count of seconds and fractions of seconds at
              # nanosecond resolution. The count is relative to an epoch at UTC midnight on
              # January 1, 1970.
            "nanos": 42, # Non-negative fractions of a second at nanosecond resolution.
                # Must be from 0 to 999,999,999 inclusive.
            "seconds": "A String", # Represents seconds of UTC time since Unix epoch.
          },
          "text": "A String", # The content of the comment, i.e. reply body.
        },
        "userComment": { # User entry from conversation between user and developer. # A comment from a user.
          "deviceMetadata": { # Characteristics of the user's device. # Information about the characteristics of the user's device.
            "deviceClass": "A String", # Device class (e.g. tablet)
            "cpuModel": "A String", # Device CPU model, e.g. "MSM8974"
            "glEsVersion": 42, # OpenGL version
            "manufacturer": "A String", # Device manufacturer (e.g. Motorola)
            "ramMb": 42, # Device RAM in Megabytes, e.g. "2048"
            "productName": "A String", # Device model name (e.g. Droid)
            "screenHeightPx": 42, # Screen height in pixels
            "nativePlatform": "A String", # Comma separated list of native platforms (e.g. "arm", "arm7")
            "cpuMake": "A String", # Device CPU make, e.g. "Qualcomm"
            "screenDensityDpi": 42, # Screen density in DPI
            "screenWidthPx": 42, # Screen width in pixels
          },
          "thumbsUpCount": 42, # Number of users who have given this review a thumbs up.
          "starRating": 42, # The star rating associated with the review, from 1 to 5.
          "originalText": "A String", # Untranslated text of the review, where the review was translated.
              # If the review was not translated this is left blank.
          "reviewerLanguage": "A String", # Language code for the reviewer. This is taken from the device
              # settings so is not guaranteed to match the language the review
              # is written in. May be absent.
          "device": "A String", # Codename for the reviewer's device, e.g. klte, flounder. May be absent.
          "androidOsVersion": 42, # Integer Android SDK version of the user's device at the time the
              # review was written, e.g. 23 is Marshmallow. May be absent.
          "appVersionCode": 42, # Integer version code of the app as installed at the time the
              # review was written. May be absent.
          "lastModified": { # A Timestamp represents a point in time independent of any time zone or local # The last time at which this comment was updated.
              # calendar, encoded as a count of seconds and fractions of seconds at
              # nanosecond resolution. The count is relative to an epoch at UTC midnight on
              # January 1, 1970.
            "nanos": 42, # Non-negative fractions of a second at nanosecond resolution.
                # Must be from 0 to 999,999,999 inclusive.
            "seconds": "A String", # Represents seconds of UTC time since Unix epoch.
          },
          "text": "A String", # The content of the comment, i.e. review body. In some cases
              # users have been able to write a review with separate title and
              # body; in those cases the title and body are concatenated and
              # separated by a tab character.
          "appVersionName": "A String", # String version name of the app as installed at the time the
              # review was written. May be absent.
          "thumbsDownCount": 42, # Number of users who have given this review a thumbs down.
        },
      },
    ],
    "authorName": "A String", # The name of the user who wrote the review.
    "reviewId": "A String", # Unique identifier for this review.
  }
list(packageName, maxResults=None, startIndex=None, translationLanguage=None, token=None, x__xgafv=None)
Lists all reviews.

Args:
  packageName: string, Package name of the app. (required)
  maxResults: integer, How many results the list operation should return.
  startIndex: integer, The index of the first element to return.
  translationLanguage: string, Language localization code.
  token: string, Pagination token. If empty, list starts at the first review.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response listing reviews.
    "reviews": [ # List of reviews.
      { # An Android app review.
        "comments": [ # A repeated field containing comments for the review.
          { # An entry of conversation between user and developer.
            "developerComment": { # Developer entry from conversation between user and developer. # A comment from a developer.
              "lastModified": { # A Timestamp represents a point in time independent of any time zone or local # The last time at which this comment was updated.
                  # calendar, encoded as a count of seconds and fractions of seconds at
                  # nanosecond resolution. The count is relative to an epoch at UTC midnight on
                  # January 1, 1970.
                "nanos": 42, # Non-negative fractions of a second at nanosecond resolution.
                    # Must be from 0 to 999,999,999 inclusive.
                "seconds": "A String", # Represents seconds of UTC time since Unix epoch.
              },
              "text": "A String", # The content of the comment, i.e. reply body.
            },
            "userComment": { # User entry from conversation between user and developer. # A comment from a user.
              "deviceMetadata": { # Characteristics of the user's device. # Information about the characteristics of the user's device.
                "deviceClass": "A String", # Device class (e.g. tablet)
                "cpuModel": "A String", # Device CPU model, e.g. "MSM8974"
                "glEsVersion": 42, # OpenGL version
                "manufacturer": "A String", # Device manufacturer (e.g. Motorola)
                "ramMb": 42, # Device RAM in Megabytes, e.g. "2048"
                "productName": "A String", # Device model name (e.g. Droid)
                "screenHeightPx": 42, # Screen height in pixels
                "nativePlatform": "A String", # Comma separated list of native platforms (e.g. "arm", "arm7")
                "cpuMake": "A String", # Device CPU make, e.g. "Qualcomm"
                "screenDensityDpi": 42, # Screen density in DPI
                "screenWidthPx": 42, # Screen width in pixels
              },
              "thumbsUpCount": 42, # Number of users who have given this review a thumbs up.
              "starRating": 42, # The star rating associated with the review, from 1 to 5.
              "originalText": "A String", # Untranslated text of the review, where the review was translated.
                  # If the review was not translated this is left blank.
              "reviewerLanguage": "A String", # Language code for the reviewer. This is taken from the device
                  # settings so is not guaranteed to match the language the review
                  # is written in. May be absent.
              "device": "A String", # Codename for the reviewer's device, e.g. klte, flounder. May be absent.
              "androidOsVersion": 42, # Integer Android SDK version of the user's device at the time the
                  # review was written, e.g. 23 is Marshmallow. May be absent.
              "appVersionCode": 42, # Integer version code of the app as installed at the time the
                  # review was written. May be absent.
              "lastModified": { # A Timestamp represents a point in time independent of any time zone or local # The last time at which this comment was updated.
                  # calendar, encoded as a count of seconds and fractions of seconds at
                  # nanosecond resolution. The count is relative to an epoch at UTC midnight on
                  # January 1, 1970.
                "nanos": 42, # Non-negative fractions of a second at nanosecond resolution.
                    # Must be from 0 to 999,999,999 inclusive.
                "seconds": "A String", # Represents seconds of UTC time since Unix epoch.
              },
              "text": "A String", # The content of the comment, i.e. review body. In some cases
                  # users have been able to write a review with separate title and
                  # body; in those cases the title and body are concatenated and
                  # separated by a tab character.
              "appVersionName": "A String", # String version name of the app as installed at the time the
                  # review was written. May be absent.
              "thumbsDownCount": 42, # Number of users who have given this review a thumbs down.
            },
          },
        ],
        "authorName": "A String", # The name of the user who wrote the review.
        "reviewId": "A String", # Unique identifier for this review.
      },
    ],
    "pageInfo": { # Information about the current page. # Information about the current page.
        #
        # List operations that supports paging return only one "page" of results. This
        # protocol buffer message describes the page that has been returned.
      "resultPerPage": 42, # Maximum number of results returned in one page.
          # ! The number of results included in the API response.
      "startIndex": 42, # Index of the first result returned in the current page.
      "totalResults": 42, # Total number of results available on the backend
          # ! The total number of results in the result set.
    },
    "tokenPagination": { # Pagination information returned by a List operation when token pagination # Pagination token, to handle a number of products that is over one page.
        # is enabled.
        #
        # List operations that supports paging return only one "page" of results. This
        # protocol buffer message describes the page that has been returned.
        #
        # When using token pagination, clients should use the next/previous token
        # to get another page of the result. The presence or absence of next/previous
        # token indicates whether a next/previous page is available and provides a
        # mean of accessing this page. ListRequest.page_token should be set to either
        # next_page_token or previous_page_token to access another page.
      "previousPageToken": "A String",
      "nextPageToken": "A String", # Tokens to pass to the standard list field 'page_token'. Whenever available,
          # tokens are preferred over manipulating start_index.
    },
  }
reply(packageName, reviewId, body=None, x__xgafv=None)
Replies to a single review, or updates an existing reply.

Args:
  packageName: string, Package name of the app. (required)
  reviewId: string, Unique identifier for a review. (required)
  body: object, The request body.
    The object takes the form of:

{ # Request to reply to review or update existing reply.
    "replyText": "A String", # The text to set as the reply. Replies of more than approximately 350
        # characters will be rejected. HTML tags will be stripped.
  }

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

Returns:
  An object of the form:

    { # Response on status of replying to a review.
    "result": { # The result of replying/updating a reply to review. # The result of replying/updating a reply to review.
      "lastEdited": { # A Timestamp represents a point in time independent of any time zone or local # The time at which the reply took effect.
          # calendar, encoded as a count of seconds and fractions of seconds at
          # nanosecond resolution. The count is relative to an epoch at UTC midnight on
          # January 1, 1970.
        "nanos": 42, # Non-negative fractions of a second at nanosecond resolution.
            # Must be from 0 to 999,999,999 inclusive.
        "seconds": "A String", # Represents seconds of UTC time since Unix epoch.
      },
      "replyText": "A String", # The reply text that was applied.
    },
  }