REST Resource: sellers.products

리소스: Product

단일 제품입니다.

JSON 표현
{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "creativeSpecifications": [
    {
      object (CreativeSpecification)
    }
  ],
  "bookingLeadDuration": string,
  "assignmentLeadDuration": string,
  "minFlightDuration": string,
  "maxFlightDuration": string,
  "slotDuration": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "currencyCode": string
}
필드
name

string

제품의 리소스 이름으로, sellers/{seller}/products/{product} 형식입니다. 예: sellers/seller111/products/product123

externalId

string

이 항목을 외부 소스에 매핑하는 데 사용되는 ID입니다.

displayName

string

필수 항목입니다. 제품의 표시 이름입니다.

최대 240바이트의 UTF-8로 인코딩되어야 합니다.

description

string

제품을 설명하는 추가 자유 형식 필드입니다.

labels

map (key: string, value: string)

이 제품을 설명하는 자유 형식 라벨 집합입니다.

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

creativeSpecifications[]

object (CreativeSpecification)

필수 항목입니다. 이 제품에 게재할 수 있는 허용 가능한 광고 소재의 목록입니다.

bookingLeadDuration

string (Duration format)

필수 항목입니다. 제품을 예약하려면 리드 기간이 필요합니다. Now +BookingLeadDuration은 광고 게재 기간 시작 후여야 합니다.

초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 's'로 끝납니다(예: "3.5s").

assignmentLeadDuration

string (Duration format)

필수 항목입니다. 광고 소재를 할당하려면 리드 기간이 필요합니다.

초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 's'로 끝납니다(예: "3.5s").

minFlightDuration

string (Duration format)

이 제품의 최소 비행 기간입니다.

초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 's'로 끝납니다(예: "3.5s").

maxFlightDuration

string (Duration format)

필수 항목입니다. 이 제품의 최대 광고 게재 기간입니다.

초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 's'로 끝납니다(예: "3.5s").

slotDuration

string (Duration format)

필수 항목입니다. 이 제품의 슬롯 기간입니다.

초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 's'로 끝납니다(예: "3.5s").

createTime

string (Timestamp format)

출력 전용입니다. 제품의 생성 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 제품의 최종 업데이트 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

state

enum (State)

출력 전용입니다. 이 제품의 상태입니다.

currencyCode

string

필수 항목입니다. ISO 4217에 정의된 3자리 대문자 통화 코드입니다.

제품 상태에 사용할 수 있는 값입니다.

열거형
STATE_UNSPECIFIED 제품 상태가 지정되지 않았거나 이 버전에서 알 수 없는 경우의 기본값입니다.
STATE_ACTIVE 제품이 사용중입니다.
STATE_DELETED 제품이 삭제되었습니다.

메서드

create

새 제품을 만듭니다.

delete

기존 제품을 삭제합니다.

get

개별 제품을 검색합니다.

list

제품을 나열합니다.

patch

기존 제품을 업데이트합니다.