---
title: "PATCH /v1/{+name}"
method: PATCH
path: "/v1/{+name}"
tags: ["publications"]
---

# PATCH /v1/{+name}

`PATCH /v1/{+name}`

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.

## Path parameters

- `name` string, required

## Query parameters

- `updateMask` string

## Request body

- ReaderEntitlements — A singleton containing all of a reader's entitlements for a publication.
  - `name` string — Output only. The resource name of the singleton.
  - `entitlements` Entitlement[] — All of the entitlements for a publication reader.
    - `subscriptionToken` string — A source-specific subscription token. This is an opaque string that the publisher provides to Google. This token is opaque and has no meaning to Google.
    - `expireTime` string, google-datetime — Required. Expiration time of the entitlement. Entitlements that have expired over 30 days will be purged. The max expire_time is 398 days from now().
    - `productId` string — Required. The publication's product ID that the user has access to. This is the same product ID as can be found in Schema.org markup (http://schema.org/productID). E.g. "dailybugle.com:basic"
    - `detail` string — The detail field can carry a description of the SKU that corresponds to what the user has been granted access to. This description, which is opaque to Google, can be displayed in the Google user subscription console for users who linked the subscription to a Google Account. Max 80 character limit.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/readerrevenuesubscriptionlinking.md) · [All operations](https://skmtc.dev/google/apis/readerrevenuesubscriptionlinking/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/readerrevenuesubscriptionlinking/revisions/37e8029ea746/schema)