컬렉션 partnerSubscriptions

리소스 PartnerSubscription

구독을 처리하는 데 필요한 정보가 포함된 구독 뷰입니다. 구독은 고객이 특정 기간 동안 Google에서 특정 리소스를 구매할 수 있도록 고객과 Google 간의 계약입니다.

구독은 단일 구매를 나타냅니다. 사용자가 구매를 취소했다가 다시 시작하거나 서비스 수준 업그레이드 또는 다운그레이드를 포함하여 구독 중인 리소스를 변경하면 새 구독으로 표시됩니다. 새 구독에는 새 name이 있지만 externalAccountId는 이전 구독과 동일합니다.

JSON 표현 

{
  "name": string,
  "externalAccountId": string,
  "version": string,
  "status": enum(Status),
  "subscribedResources": [
    {
      object(SubscribedResource)
    }
  ],
  "requiredApprovals": [
    {
      object(RequiredApproval)
    }
  ],
  "startDate": {
    object(Date)
  },
  "endDate": {
    object(Date)
  },
  "createTime": string,
  "updateTime": string,
}
필드 이름 유형 설명
name string 이 구독의 이름입니다. 구독이 만들어지면 자동으로 생성됩니다. subscriptions/* 형식이며 여기서 *는 비공개 문자열입니다.
externalAccountId string 이 구독을 소유한 계정의 식별자입니다. 이 식별자는 특정 계정 및 구독 제공자에 고유합니다.
version string 이 레코드의 비공개 버전 번호입니다. 구독에 대한 업데이트를 쉽게 확인하는 데 사용할 수 있습니다.
status enum(Status) 이 구독의 현재 상태입니다.
subscribedResources[] object(SubscribedResource) 이 구독에 포함된 리소스입니다. 모든 리소스는 동일한 구독 제공자에 속해야 합니다.
requiredApprovals[] object(RequiredApproval) 구독이 ACTIVE 상태가 되기 위해 부여해야 하는 승인 집합을 나타냅니다. 구독에 필요한 승인이 없는 경우 ACTIVE 상태가 되기 위해 승인이 필요하지 않습니다.
startDate object(Date) 이 구독이 시작된 날짜입니다.
endDate object(Date) 상태가 COMPLETE이면 이 구독이 종료된 날짜이며 그렇지 않으면 비어 있습니다.
createTime string

구독이 만들어진 타임스탬프입니다. 입력으로 제공되면 서버에서 이를 무시합니다. @OutputOnly

RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예: "2014-10-02T15:01:23.045123456Z"
updateTime string

구독이 마지막으로 수정된 타임스탬프입니다. 입력으로 제공되면 서버에서 이를 무시합니다. @OutputOnly

RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예: "2014-10-02T15:01:23.045123456Z"

상태

구독의 현재 상태입니다.

열거형 값 설명
UNKNOWN_STATUS 기본값 이 값은 반환되지 않아야 합니다.
ACTIVE 구독이 처리되었으며 현재 진행 중입니다.
COMPLETE 구독이 활성 상태였지만 현재 종료되었습니다. 구독이 완료로 표시되면 다시 ACTIVE 상태가 되지 않습니다.
PENDING 구독이 만들어졌지만 아직 시작되지 않았습니다. 시작일이 미래 날짜이거나 RequiredApprovals가 하나 이상 필요합니다.
CANCELED 구독을 처리할 수 없습니다. ACTIVE 상태가 되기 전에 취소되었습니다.

SubscribedResource

구독 제공자, 리소스, 구매한 리소스를 식별하는 추가 메타데이터를 포함하여 구독에서 구매한 단일 리소스를 식별합니다.

JSON 표현 

{
  "subscriptionProvider": string,
  "resource": string,
  "labels": {
    string: string,
    ...
  },
}
필드 이름 유형 설명
subscriptionProvider string 구독 중인 리소스의 제공자 이름입니다. 구독이 기존 API와 연결된 경우 해당 API의 URL이어야 합니다(예: example.googleapis.com). 리소스가 기존 API와 연결되어 있지 않으면 이 API의 URL 앞에 추가된 제공자의 이름이 됩니다(예: example-cloudbilling.googleapis.com).
resource string 구독해야 하는 리소스 유형의 이름입니다. 구매 대상을 설명하는 카멜 표기법 이름으로, 새 리소스 유형을 구성할 때 정의됩니다.
labels map (key: string, value: string)

이 리소스의 라벨 컬렉션입니다. 이 리소스에 대한 커스텀 구성을 제공하거나 추가 메타데이터를 저장하는 데 사용할 수 있습니다.

라벨의 일반적인 용도는 여러 수준의 구독 유형에 대한 서비스 수준을 지정하는 것입니다. 예를 들어 실버 및 골드 수준의 지원 구독은 가능한 값이 'Gold'및 'Silver'인 'SupportLevel' 키가 있는 라벨을 사용할 수 있습니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

RequiredApproval

구독을 시작하기 전에 제공해야 하는 승인을 나타냅니다. 자동 승인 또는 수동 승인을 나타낼 수 있습니다. 구독 생성 시 승인이 자동으로 만들어집니다. 승인을 승인하거나 거부할 수 있습니다. 승인 또는 거부 후에는 승인 상태를 변경할 수 없습니다.

JSON 표현 

{
  "name": string,
  "status": enum(Status),
  "approvalTime": string,
  "approvalNote": string,
}
필드 이름 유형 설명
name string 이 승인의 이름입니다. 'default-approval' 값이 있어야 합니다.
status enum(Status) 이 승인의 상태입니다. 승인이 있는 구독이 만들어지면 PENDING 상태여야 합니다. 승인을 업데이트할 때 APPROVED 또는 DENIED로 설정해야 합니다.
approvalTime string

승인이 부여되거나 거부된 시간입니다. 자동으로 설정됩니다. @OutputOnly

RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예: "2014-10-02T15:01:23.045123456Z"
approvalNote string 상태 변경에 대한 설명입니다. 상태가 APPROVED인 경우 선택사항이며 상태가 DENIED인 경우 필수사항입니다.

상태

필수 승인의 현재 상태를 나타냅니다.

열거형 값 설명
STATUS_UNSPECIFIED 기본값 이 값은 반환되지 않아야 합니다.
PENDING 승인이 부여되거나 거부되지 않았습니다.
APPROVED 승인이 부여되었습니다.
DENIED 승인이 거부되었습니다.

날짜

전체 달력 날짜(예: 생년월일)를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 일이 중요하지 않아 연도 및 월을 나타내기 위해 일은 0일 수 있습니다(예: 신용카드 만료일). 연도와 상관없이 월 및 일을 나타내기 위해 연도는 0일 수 있습니다(예: 기념일). 관련 유형은 [google.type.TimeOfDay][] 및 google.protobuf.Timestamp입니다.

JSON 표현 

{
  "year": number,
  "month": number,
  "day": number,
}
필드 이름 유형 설명
year number 연도. 1~9999 사이의 값이어야 합니다. 단, 연도 없이 날짜를 지정할 경우 0입니다.
month number 월. 1~12 사이의 값이어야 합니다.
day number 일. 1~31 사이의 값이어야 하며 해당 연도와 월에 유효해야 합니다. 단, 일이 중요하지 않아 연도/월을 지정할 경우 0입니다.

메서드

메서드 설명
approve 파트너 구독에서 PENDING 승인 상태를 APPROVED로 변경합니다.
deny 파트너 구독에서 PENDING 승인 상태를 DENIED로 변경합니다.
get 단일 구독의 현재 상태를 검색합니다.
list 지정된 외부 계정 ID의 모든 구독을 나열합니다.