Google Developer

1. Overview

The Google Developer tool integrates with the Google Play Developer API, allowing you to programmatically manage your application's presence on the Google Play Store. Its primary function is to interact with user feedback and application data.

With the GoInsight Google Developer node, you can automate the entire lifecycle of managing user reviews for your Android applications. This enables you to build workflows that monitor feedback, respond to users, and analyze sentiment directly within your automated processes. Key capabilities include:

• Fetching reviews individually by their unique ID.
• Listing all reviews for an application, with support for pagination.
• Replying directly to user reviews to engage with your community.

2. Prerequisites

Before using this node, you need to have the following:

• A valid Google Developer account with an application published on the Google Play Store.
• Appropriate permissions within your Google Cloud project and Google Play Console to create and manage API credentials (OAuth 2.0 client IDs) that have access to the Google Play Developer API.

3. Credentials

For a detailed guide on how to obtain and configure your credentials, please refer to our official documentation: Credentials Configuration Guide.

4. Supported Operations

This node provides operations centered around managing your application's user reviews on the Google Play Store.

Summary

The following table summarizes the available operations for the Review resource.

Operation Details

Get a Review

Retrieves a specific review from the Google Play Developer API for the specified application.

Input Parameters:

• PackageName: The package name of the application containing the review.
• ReviewId: The unique identifier of the review to retrieve.

Options:

• TranslationLanguage: ISO 639-1 language code to translate the review content.

Output:

• ReviewId (string): The unique identifier of the review.
• AuthorName (string): The name of the review author.
• Text (string): The text content of the review.
• LastModified (string): The timestamp when the review was last modified.
• StarRating (number): The star rating of the review (1-5).
• ReviewerLanguage (string): The language code of the reviewer.
• Device (string): The device information of the reviewer.
• AndroidOsVersion (number): The Android OS version of the reviewer's device.
• AppVersionCode (number): The version code of the app when the review was submitted.
• AppVersionName (string): The version name of the app when the review was submitted.
• ThumbsUpCount (number): The number of thumbs up for this review.
• ThumbsDownCount (number): The number of thumbs down for this review.
• DevCommentText (string): The text content of the developer's reply to this review.
• DevCommentLastModified (string): The timestamp when the developer's comment was last modified.
• DeviceMetadata (string): Device metadata information in JSON string format.
• StatusCode (number): Operation result code: 200 for success, -1 for parameter validation errors, 500 for internal errors, other HTTP status codes for API errors.
• ErrorMessage (string): Error description if any; empty string on success.

List Review

Retrieves a list of reviews for the specified Android application via Google Developer API.

Input Parameters:

• PackageName: The package name of the Android application (e.g., com.example.app).

Options:

• Token: Pagination token returned by a previous call.
• StartIndex: The zero-based index of the first review to return.
• MaxResult: Maximum number of reviews to return.
• TranslationLanguage: BCP-47 language code (e.g., zh, en) for translating review text.

Output:

• Reviews (string-array): Array of JSON strings, each containing a review object as returned by the API.
• NextPageToken (string): Pagination token for retrieving the next page of results, empty if no more pages.
• StatusCode (number): Operation status code: 200 (success), 500 (API request failure), -1 (parameter validation error).
• ErrorMessage (string): Error message if parameter validation fails or API request error, empty otherwise.

Reply a Review

Replies to a specific Google Play Store in-app review using the provided access token, package name, review ID, and reply text.

Input Parameters:

• PackageName: The application’s package name (e.g., com.example.app).
• ReviewId: The ID of the review to reply to.
• ReplyText: The text to include in the reply.

Output:

• Result (string): A JSON string containing the reply details.
• StatusCode (number): Operation status code: 200 (success), non-200 (HTTP error), 500 (exception), -1 (parameter error).
• ErrorMessage (string): Error description if operation fails, empty otherwise.

5. Example Usage

This section will guide you through creating a simple workflow to fetch the latest reviews for your Android application.

The workflow will consist of three nodes: Start -> Google Developer: List Review -> Answer.

1. Add the Tool Node

• In the workflow canvas, click the + button to add a new node.
• Select the "Tool" tab in the pop-up panel.
• Find and select "Google Developer" from the list of tools.
• From the list of supported operations for Google Developer, click on "List Review" to add the node to your canvas.

2. Configure the Node

• Click on the newly added "List Review" node to open its configuration panel on the right.
• Credentials Configuration: At the top of the panel, find the credentials field. Click the dropdown menu and select your pre-configured Google Developer credentials.
• Parameter Configuration: Fill in the required parameters to specify which reviews to fetch.
  • PackageName: Enter the unique package name of your application, for example, com.yourcompany.yourapp.
  • MaxResult (Optional): To limit the number of reviews returned, you can enter a number here, such as 10. If left blank, the API's default limit will be used.

3. Run and Validate

• Once all required parameters are correctly filled, any error indicators on the workflow canvas should disappear.
• Click the "Test Run" button in the top-right corner of the canvas to execute the workflow.
• After a successful execution, you can click the logs icon in the top-right corner to view the detailed inputs and outputs of the node, verifying that the reviews were fetched correctly.

After completing these steps, your workflow is fully configured. When you run it, it will connect to the Google Play Developer API and retrieve a list of the most recent reviews for your specified application.

6. FAQs

Q: I'm receiving a 401 Unauthorized or 403 Forbidden error. What could be the cause?

A: These errors typically indicate an issue with your credentials or permissions. Please check the following:

• Correct Credentials: Ensure you have selected the correct Google Developer credentials in the node configuration.
• API Enabled: Verify that the "Google Play Android Developer API" is enabled in your Google Cloud project.
• OAuth Consent Screen: Make sure your OAuth consent screen is properly configured and that your application is not in "testing" mode if you are using production credentials.
• Permissions: The user account used to generate the credentials must have sufficient permissions in the Google Play Console to access reviews.

Q: How do I process the Reviews output from the "List Review" action?

A: The Reviews output is an array of strings, where each string is a complete JSON object representing a single review. To work with individual review details (like author, text, or rating), you will typically need to add a "Code" node after the "List Review" node. In the Code node, you can loop through the array and use JSON.parse() on each string to convert it into a usable object.

Q: How do I handle pagination to get all reviews?

A: The "List Review" operation supports pagination. If there are more reviews to fetch, the NextPageToken output field will contain a value. To get the next page, add another "List Review" node (or create a loop) and pass the NextPageToken from the first node's output into the Token input parameter of the second node. Repeat this process until the NextPageToken output is empty.

7. Official Documentation

For more in-depth information about the API's capabilities and parameters, please refer to the official documentation:

Google Play Developer API Documentation