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.

Link your account with Account Linking Reset your local account linking state cache

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>