Method: subscriptions.patch

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

Chat 대상 리소스의 구독의 경우 다음과 같이 구독을 업데이트할 수 있습니다.

HTTP 요청

PATCH https://workspaceevents.googleapis.com/v1beta/{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/chat.app.memberships
  • https://www.googleapis.com/auth/chat.app.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.app.spaces.readonly
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

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