Method: subscriptions.patch

Google Workspace 구독을 업데이트하거나 갱신합니다. 이 방법을 사용하는 방법을 알아보려면 Google Workspace 구독 업데이트 또는 갱신을 참고하세요.

HTTP 요청

PATCH https://workspaceevents.googleapis.com/v1/{subscription.name=subscriptions/*}

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

경로 매개변수

매개변수
subscription.name

string

식별자. 정기 결제의 리소스 이름입니다.

형식: subscriptions/{subscription}

쿼리 매개변수

매개변수
updateMask

string (FieldMask format)

선택사항입니다. 업데이트할 필드입니다. 생략하면 요청에 포함된 모든 필드가 업데이트됩니다.

구독에서 다음 필드 중 하나를 업데이트할 수 있습니다.

  • expireTime: 정기 결제가 만료되는 시점의 타임스탬프입니다.
  • ttl: 정기 결제의 TTL(수명) 또는 기간입니다.
  • eventTypes: 타겟 리소스에 대해 수신할 이벤트 유형 목록입니다.

정기 결제를 완전히 대체하려면 (PUT에 상응) *를 사용하세요. 생략된 필드는 빈 값으로 업데이트됩니다.
validateOnly

boolean

선택사항입니다. true로 설정하면 요청을 검증하고 미리 보이지만 정기 결제를 업데이트하지는 않습니다.

요청 본문

요청 본문에 Subscription의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

  • metadata 필드에는 빈 배열이 포함됩니다.
  • response 필드에는 업데이트된 Subscription 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly

자세한 내용은 승인 가이드를 참고하세요.