Method: monetization.subscriptions.batchUpdate

구독 배치를 업데이트합니다.

최대 업데이트 처리량을 달성하려면 중첩된 요청의latencyTolerance 필드를 PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT로 설정합니다.

HTTP 요청

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions:batchUpdate

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
packageName

string

필수 항목입니다. 정기 결제를 업데이트해야 하는 상위 앱 (패키지 이름)입니다. 모든 구독 리소스의 packageName 필드와 같아야 합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "requests": [
    {
      object (UpdateSubscriptionRequest)
    }
  ]
}
필드
requests[]

object (UpdateSubscriptionRequest)

필수 항목입니다. 최대 100개의 요소로 구성된 업데이트 요청 목록 모든 요청은 서로 다른 구독을 업데이트해야 합니다.

응답 본문

BatchUpdateSubscription의 응답 메시지입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현
{
  "subscriptions": [
    {
      object (Subscription)
    }
  ]
}
필드
subscriptions[]

object (Subscription)

업데이트된 구독 목록입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/androidpublisher

UpdateSubscriptionRequest

Subscription.patch 요청 메시지입니다.

JSON 표현
{
  "subscription": {
    object (Subscription)
  },
  "updateMask": string,
  "regionsVersion": {
    object (RegionsVersion)
  },
  "allowMissing": boolean,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
필드
subscription

object (Subscription)

필수 항목입니다. 업데이트할 구독입니다.

updateMask

string (FieldMask format)

필수 항목입니다. 업데이트할 필드 목록입니다.

필드의 정규화된 이름을 쉼표로 구분한 목록입니다. 예: "user.displayName,photo"

regionsVersion

object (RegionsVersion)

필수 항목입니다. 구독에 사용되는 사용 가능한 리전의 버전입니다.

allowMissing

boolean

선택사항입니다. true로 설정되고 지정된 packageName 및 productId를 사용하는 구독이 없으면 구독이 생성됩니다.

새 구독이 생성되면 updateMask는 무시됩니다.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

선택사항입니다. 이 제품 업데이트 전파의 지연 시간 허용 범위입니다. 기본값은 지연 시간에 민감합니다.