Subscribe with Google

Newsletter

Survey

Using Extended Access

Syncing Publisher Entitlements to Google

Receiving Entitlements from Google

Content examples

Account Linking

Client-side Javascript Demo

This button will attempt to link your Google account to a "publisher" account. Afterwards, if you authenticate as the same user in the Publication API example, the default linked entitlements will be visible via the /entitlements endpoint.

To unlink this account (and remove the entitlements), visit the Google My Account - Subscriptions management page and choose "unlink" next to the newly linked publication.

Local and Linked State

Resetting the local account linking state using the sample accountLinkingPersistence class does not reset or unlink the user in their My Account page. It is a convenience button to help developers quickly reset the local state only.

Implementation Details

Read the documentation.

Entitlements API and other required endpoints for OAuth 2.0 flow need to be defined in Publisher Center. For more information setting up endpoints, please read Set up Subscribe with Google for your publication.

The Console DevTool is available to test account linking. For more information, please read Test account linking.

Sample Implementation

  1. Include swg.js: <script async src="https://news.google.com/swg/js/v1/swg.js"></script>.
  2. Include the appropriate structured data markup for the page.
  3. Load the sample page and click on "Link your account" button.
<script async type="application/javascript" src="https://news.google.com/swg/js/v1/swg.js"></script>
<script type="application/ld+json">
  {
    "@context": "http://schema.org",
    "@type": "NewsArticle",
    "headline": "Reader Revenue Demo",
    "image": "/icons/icon-2x.png",
    "datePublished": "2025-02-05T08:00:00+08:00",
    "dateModified": "2025-02-05T09:20:00+08:00",
    "author": {
    "@type": "Person",
    "name": "John Doe"
    },
    "publisher": {
        "name": "Reader Revenue Demo",
        "@type": "Organization",
        "@id": "CAowqfCKCw",
        "logo": {
        "@type": "ImageObject",
        "url": "/icons/icon-2x.png"
        }
    },
    "description": "This example loads a carousel of offers on click.",
    "isAccessibleForFree": "False",
    "isPartOf": {
        "@type": ["CreativeWork", "Product"],
        "name" : "Reader Revenue Demo",
        "productID": "CAowqfCKCw:basic"
    }
  }
</script>
<script>
  (self.SWG = self.SWG || []).push( async subscriptions => {
    // For OAuth 2.0 authorization code flow the Promise should resolve with { authCode: 'auth_code' }
    // For OAuth 2.0 implicit flow the  Promise should resolve with { token: 'entitlements_access_token' }
    const requestPromise = Promise.resolve({ token: 'publisher_provided_access_token' });
    const result = await subscriptions.saveSubscription(() => requestPromise);
    console.log("User Acceptance", result ? "Yes" : "No");
  })
</script>