
Prerequisites
Before you start, make sure you have:- A Dovetail workspace on any paid plan.
- Access to your organization’s Google Play Console with View app information permission. If you aren’t a developer, ask your developer team to add your email to your organization’s Google Console with View app information permissions.
- The package name for each app you want to import — for example,
com.acme.mobile. You’ll enter these during setup. - Can edit or Full access on the Channel where you want to import reviews. Manage permissions in the Channel’s Share settings.
- A shared Google account used by the person setting up the integration — Dovetail authenticates against a real Google user.
Set up the integration
You can start the connection from the Channel you want to import into, or from Settings → Integrations.- Open the Channel where you want to import reviews, or create a new one.
- Select Add source.
- In the Connect data source dialog, select Google Play.
- Review the requirements on the Connect Google Play Store screen and select Continue. Dovetail lists three prerequisites here:
- To input your developer name. If you aren’t a developer, ask your developer team to add your email to your organization’s Google Console with View app information permissions.
- Google Play store login credentials. Required to authorize the connection. If a Google Play Store account owner lacks Dovetail access, you can invite them as a free user from this screen.
- ‘Can edit’ or ‘Full access’ to the Channel. Required to access the Channel. Manage permissions in the Channel’s Share settings.
Authorize Dovetail
When you continue, a Google sign-in window opens.- Sign in with the Google account that has access to your Google Play Console.
- Approve the requested permissions.
androidpublisher scope is the only scope Google offers for programmatic access to reviews — it’s an all-or-nothing scope. To restrict what Dovetail can see, connect a Google user (or a Play Console user) who has access only to the apps you want Dovetail to read. You can revoke the connection at any time from your Google Account permissions.
Add the apps you want to import
After authorizing, you’ll see the Connect with your app store step.- Enter one or more app package names. You can paste multiple, separated by commas — for example,
com.acme.mobile, com.acme.tablet. - Select Add. Dovetail validates each package name against the Google Play API.
- Valid IDs move into the list below the input.
- Invalid IDs surface as an inline error:
Invalid app IDs [com.example.bad]. Remove or correct them and try again.
- Repeat until you’ve added every app you want to connect. You can add up to 10 apps per integration. If you need more than 10, reach out to support.
- Select Continue.
com.company.app and is unique to that app.
Confirm what to analyze
On Configure what to analyze, Dovetail pre-selects every app you validated in the previous step — you don’t need to pick them again.- Apps. All validated apps are selected by default. You can uncheck any you don’t want in this Channel.
- From the last. Fixed to Last 7 days. Google Play’s Reviews API only exposes reviews from the last 7 days — this is a hard limit set by Google, not a Dovetail-side setting. Anything older isn’t available through the API. See Backfilling older reviews below if you need historical data.
What Dovetail imports
For each review, Dovetail creates one data point in the Channel with the review text, the developer’s reply (if any), and a link back to the review in the Play Store. Fields Dovetail imports as metadata:- The review comment text as the analyzed content.
- The developer’s reply (if present), attributed to Developer, as a second turn in the conversation.
- The reviewer’s display name (as returned by Google — often a generic pseudonym).
- A direct link back to the review at
play.google.com/store/apps/details?id=<appId>&reviewId=<reviewId>. - The review’s last-modified timestamp as the data point’s date.
- Reviews older than 7 days at the time Dovetail queries the API — Google doesn’t expose them.
- Star-rating-only reviews with no comment text.
- Reviewer email addresses. Google Play doesn’t expose them.
- Custom Play Console labels, internal notes, or A/B experiment context.
- Play Console policy actions, takedowns, or moderation events.
- Sentiment, topic, or category tags computed inside the Play Console.
- Screenshots or attachments — Google Play reviews are text-only.
- In-app purchase records, crash reports, or performance metrics.
- Historical revisions of a review after the reviewer edits it — Dovetail keeps whichever version it saw most recently.
Sync behavior
- Initial backfill. On first connection, Dovetail imports reviews from the last 7 days for each connected app.
- Ongoing sync. After the initial import, Dovetail syncs about once an hour — new and updated reviews land in the Channel automatically, typically within an hour of being posted. The schedule is fixed; there’s no way to trigger a manual sync or change the frequency.
- Scope. Every review returned by the Reviews API for the connected apps, including reviews from any country and language, is imported. Dovetail doesn’t filter by rating, country, device, or language.
- Developer replies. If you reply to a review in Play Console, Dovetail imports the reply as a follow-up turn on the same data point.
- Rate limits. The Reviews API has per-project quotas set by Google. Dovetail retries transient rate-limit errors with backoff. Sustained failures show up in the Channel’s source card as a re-authorization or error banner.
Backfilling older reviews
Because the Reviews API only returns the last 7 days, Dovetail can’t reach back further through the API. If you need historical reviews:- In Google Play Console, download reviews as a CSV from the Ratings and reviews report.
- In the Channel, add the CSV as a second data source. Dovetail will analyze the historical reviews alongside the ongoing Google Play sync.
Troubleshooting
I authorized, but no reviews are showing up.- Google Play only exposes reviews from the last 7 days. If none of your apps received a reviewed comment in that window, there’s nothing for Dovetail to import. Check the Play Console’s Ratings and reviews report to confirm.
- Star-rating-only reviews with no text aren’t imported.
- Confirm the Google account you authorized with has View app information permission on the connected apps in Play Console.
- Reviews with no comment text (star ratings only) aren’t imported.
- If a reviewer edited or deleted a review before Dovetail’s next poll, the newer version overwrites the older one; deleted reviews stop syncing.
- Some reviews may appear in Play Console’s UI before they appear in the API — Google’s API can lag by a few minutes.
- The package name must be exact — check for typos, extra spaces, or the wrong case.
- The authorized Google account must have access to that app in Play Console. If a colleague owns the app, ask them to grant you View app information permission.
- Confirm the app is published (or at least visible) in the same Play Console organization the account belongs to.
- The Google refresh token expired, was revoked in your Google Account, or the connected user lost access to one or more apps in Play Console. From the source card, select Reconnect and sign in again. If the underlying issue was permissions, restore access in Play Console first.
- If some apps are inaccessible, you’ll see this message: “The Dovetail service account no longer has access to one or more Google Play apps. Re-grant ‘View app information’ and ‘Reply to reviews’ in Play Console.”
- Each Dovetail integration authorizes against one Google account. If that account has access to apps across multiple Play Console organizations, you can add package names from any of them, up to the 10-app cap. If you need apps from organizations the account can’t reach, connect a second Google account by adding a separate data source with a different signed-in user.
- Dovetail respects Google Play’s per-project quotas and retries with backoff. Persistent 429 responses on your project will delay sync until Google restores quota — you don’t need to do anything on your side.
Disconnect or delete the Google Play Store source
Disconnecting stops new data from importing but keeps everything already imported. Deleting removes the source and all its data points from the Channel — this is permanent. To disconnect:- Open the Channel and select Sources (or the source card menu).
- Select ••• → Disconnect.
-
Confirm in the Disconnect data source dialog:
Are you sure you want to disconnect <source name> from <Channel name>? This will immediately stop the Channel from ingesting any new data. Any data already imported from this source will remain in the Channel.
- Select Disconnect.
- From the same source menu, select ••• → Delete.
-
Confirm in the Delete data source dialog:
Are you sure you want to delete <source name> from <Channel name>? This will delete all associated data points. This is permanent and cannot be undone.
- Select Delete.
- Go to Google Account → Security → Third-party apps with account access.
- Find Dovetail in the list and select Remove access.
FAQs
How do I find my Google Play Store app’s package name?
How do I find my Google Play Store app’s package name?
com.spotify.music. Here’s how to find it:- From the Play Store listing (easiest). Open the app’s Play Store page and look at the URL. The package name is the value after
id=. For example, inhttps://play.google.com/store/apps/details?id=com.dovetail.support.app&hl=en_US, the package name iscom.dovetail.support.app. Ignore everything from&onward (&hl=en_USis just the display language). - From Google Play Console. Open the app. The package name appears beneath the app’s name and in the Console URL for that app.
- From your developer team. It’s the
applicationIdin the app’sbuild.gradle.
What if I see an error after entering the package name?
What if I see an error after entering the package name?
How often does Dovetail sync reviews from Google Play?
How often does Dovetail sync reviews from Google Play?
Can I make it sync more often or on demand?
Can I make it sync more often or on demand?
How far back does the import go? Can I get my older reviews?
How far back does the import go? Can I get my older reviews?
- When you connect an app, we import the reviews from the past 7 days.
- From then on, hourly syncing keeps you fully up to date (an hour is well within Google’s 7-day window, so nothing is missed).
- To bring in older historical reviews, download a CSV export from your Google Play Console and import it into Channels directly. This is the only way to backfill beyond 7 days, and it’s a Google limitation that affects every tool, not just Dovetail.
Is there a limit to how many reviews or apps I can sync?
Is there a limit to how many reviews or apps I can sync?
What happens if Google’s limits are reached?
What happens if Google’s limits are reached?
Why did my Google Play connection stop working?
Why did my Google Play connection stop working?
What if I have more technical questions about this integration?
What if I have more technical questions about this integration?