Skip to main content

Google Play Console

This page describes how to connect Google Play Console to Daspire.

Prerequisites​

  • A Google Play Console account with access to the selected Android apps.
  • Permission to view app reviews for review sync.
  • Global app information access and global financial data access when syncing monthly financial reports.
  • Google Play Developer Reporting API enabled for the Google Cloud project when syncing vitals.

Setup Guide​

  1. Select Google Play Console from the Source list.

  2. Enter a Source Name.

  3. Click Authenticate and complete Google OAuth.

  4. Enter one or more Android Package Names, for example com.example.app.

  5. Choose which stream groups to sync:

    • Sync Reviews imports app reviews.
    • Sync Financial Reports imports monthly sales and earnings report files from Google Play's Cloud Storage report bucket.
    • Sync Vitals imports Android vitals from the Play Developer Reporting API.

  6. For financial reports, copy the Financial Reports Cloud Storage URI from Play Console:

    • In Play Console, open Download reports > Financial.
    • Click Copy Cloud Storage URI.
    • Paste a URI such as gs://pubsite_prod_rev_01234567890987654321/sales.
    • Daspire stores only the internal bucket id, such as pubsite_prod_rev_01234567890987654321.

  7. Set First Financial Report Month to the first month that should be included in the initial historical backfill, for example 2024-01.

  8. Leave Financial Report Refresh Window (Months) blank for the default behavior. Daspire automatically detects new or modified Google Play report files from Cloud Storage metadata on later syncs. Set this field only when you want Daspire to also force re-read the most recent N report months on every sync, for example 3 or 6.

  9. Leave End Date blank for ongoing syncs. Use it only for one-time backfills or to freeze the report range.

  10. Click Save & Test.

Financial Report Refresh Behavior​

Google Play financial reports are monthly files in a private Cloud Storage report bucket. Recent reports can be corrected or supplemented after initial publication. Daspire handles this in two layers:

  • New or modified report files are detected through Cloud Storage object metadata and synced automatically.
  • The optional refresh window can force a conservative rolling re-read of the latest N report months.

The refresh window is not the historical start month. Use First Financial Report Month for the first backfill, and use Financial Report Refresh Window (Months) only for ongoing correction capture.

Supported Sync Modes​

The Google Play Console source supports:

  • Incremental sync for reviews, vitals, and financial reports.
  • Full refresh for financial report streams.

Troubleshooting​

If financial report access fails, confirm that the authenticated Google user can open the Play Console financial reports page and copy the Cloud Storage URI. The user must have account-level access to monthly reports and financial data.

If vitals access fails, confirm that the Google Play Developer Reporting API is enabled for the Google Cloud project used by the OAuth credentials and that the OAuth user has Play Console access to the selected app package names.