Reader Revenue Subscription Linking API (readerrevenuesubscriptionlinking:v1)

2023-02-22

4 new methods | New API

Additions

    Methods
  • readerrevenuesubscriptionlinking.publications.readers.updateEntitlements

      Description: Updates the reader entitlements for a publication reader. The entire reader entitlements will be overwritten by the new reader entitlements in the payload, like a PUT. - Returns PERMISSION_DENIED if the caller does not have access. - Returns NOT_FOUND if the reader does not exist.

      Parameters:

        name

          Type: string

          Description: Output only. The resource name of the singleton.

          Location: path

          Required: Yes

          Pattern: ^publications/[^/]+/readers/[^/]+/entitlements$

        updateMask

          Type: string

          Description: Optional. The list of fields to update. Defaults to all fields.

          Format: google-fieldmask

          Location: query

      HTTP Method: PATCH

      Flat Path: v1/publications/{publicationsId}/readers/{readersId}/entitlements

      Path: v1/{+name}

      Parameter Order: name

  • readerrevenuesubscriptionlinking.publications.readers.get

      Description: Gets a reader of a publication. Returns NOT_FOUND if the reader does not exist.

      HTTP Method: GET

      Path: v1/{+name}

      Parameters:

        name

          Type: string

          Required: Yes

          Pattern: ^publications/[^/]+/readers/[^/]+$

          Description: Required. The resource name of the reader. Format: publications/{publication_id}/readers/{ppid}

          Location: path

      Parameter Order: name

      Flat Path: v1/publications/{publicationsId}/readers/{readersId}

  • readerrevenuesubscriptionlinking.publications.readers.getEntitlements

      HTTP Method: GET

      Flat Path: v1/publications/{publicationsId}/readers/{readersId}/entitlements

      Parameter Order: name

      Path: v1/{+name}

      Parameters:

        name

          Required: Yes

          Type: string

          Pattern: ^publications/[^/]+/readers/[^/]+/entitlements$

          Description: Required. The name of the reader entitlements to retrieve. Format: publications/{publication_id}/readers/{reader_id}/entitlements

          Location: path

      Description: Gets the reader entitlements for a publication reader. - Returns PERMISSION_DENIED if the caller does not have access. - Returns NOT_FOUND if the reader does not exist.

  • readerrevenuesubscriptionlinking.publications.readers.delete

      Flat Path: v1/publications/{publicationsId}/readers/{readersId}

      Parameter Order: name

      HTTP Method: DELETE

      Parameters:

        force

          Description: If set to true, any entitlements under the reader will also be purged.

          Location: query

          Type: boolean

        name

          Type: string

          Description: Required. The resource name of the reader. Format: publications/{publication_id}/readers/{ppid}

          Location: path

          Required: Yes

          Pattern: ^publications/[^/]+/readers/[^/]+$

      Path: v1/{+name}

      Description: Removes a publication reader, effectively severing the association with a Google user. If `force` is set to true, any entitlements for this reader will also be deleted. (Otherwise, the request will only work if the reader has no entitlements.) - If the reader does not exist, return NOT_FOUND. - Return FAILED_PRECONDITION if the force field is false (or unset) and entitlements are present.