REST Resource: accounts.products

리소스: Product

규칙 및 보조 데이터 소스를 적용한 후 여러 product inputs에서 빌드된 처리된 제품입니다. 처리된 제품은 판매자 센터 계정, 쇼핑 광고, Google 플랫폼의 다른 표시 경로에 표시되는 제품과 일치합니다. 각 제품은 정확히 하나의 기본 데이터 소스 제품 입력과 여러 개의 보조 데이터 소스 입력으로 빌드됩니다. 제품 입력을 삽입, 업데이트 또는 삭제한 후 업데이트된 처리된 제품을 검색할 수 있기까지 몇 분 정도 걸릴 수 있습니다.

처리된 제품 및 하위 메시지의 모든 필드는 몇 가지 예외를 제외하고 제품 데이터 사양의 해당 속성 이름과 일치합니다.

JSON 표현 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
필드
name

string

제품 이름입니다. 형식: "{product.name=accounts/{account}/products/{product}}", 여기서 마지막 섹션 product은 4개의 부분으로 구성됩니다. channel~contentLanguage~feedLabel~offerId 제품 이름의 예는 'accounts/123/products/online~en~US~sku123'입니다.
channel

enum (ChannelEnum)

출력 전용입니다. 제품의 채널입니다.
offerId

string

출력 전용입니다. 제품의 고유 식별자입니다. 이는 제품 입력과 처리된 제품에서 동일합니다. 제출 시 선행 및 후행 공백이 제거되고 여러 공백은 단일 공백으로 대체됩니다. 자세한 내용은 제품 데이터 사양을 참고하세요.
contentLanguage

string

출력 전용입니다. 제품의 ISO 639-1 언어 코드(두 글자)입니다.
feedLabel

string

출력 전용입니다. 제품의 피드 라벨입니다.
dataSource

string

출력 전용입니다. 제품의 기본 데이터 소스입니다.
attributes

object (Attributes)

출력 전용입니다. 제품 속성 목록입니다.
customAttributes[]

object (CustomAttribute)

출력 전용입니다. 맞춤 (판매자 제공) 속성 목록입니다. 또한 데이터 사양의 속성을 일반 형식 (예: { "name": "size type", "value": "regular" })으로 제출하는 데 사용할 수 있습니다. 이는 Buy on Google에 사용되는 추가 속성 등 API에 의해 명시적으로 노출되지 않는 속성을 제출하는 데 유용합니다.
productStatus

object (ProductStatus)

출력 전용입니다. 제품 상태, 데이터 유효성 검사 문제, 즉 비동기식으로 계산된 제품에 관한 정보입니다.
versionNumber

string (int64 format)

출력 전용입니다. 제품의 기존 버전 (최신성)을 나타냅니다. 이 버전은 여러 업데이트가 동시에 실행될 때 올바른 순서를 유지하는 데 사용할 수 있습니다.

이 속성을 설정하면 버전 번호가 기존 제품의 현재 버전 번호보다 낮은 경우 삽입이 방지됩니다. 현재 versionNumber를 사용하여 재삽입 (예: 30일 후 제품 업데이트)을 실행할 수 있습니다.

기본 데이터 소스에 삽입하는 경우에만 지원됩니다.

작업이 방지되면 중단된 예외가 발생합니다.

ProductStatus

제품 상태, 데이터 유효성 검사 문제, 즉 비동기식으로 계산된 제품에 관한 정보입니다.

JSON 표현 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
필드
destinationStatuses[]

object (DestinationStatus)

제품의 의도한 대상 위치입니다.
itemLevelIssues[]

object (ItemLevelIssue)

제품과 관련된 모든 문제의 목록입니다.
creationDate

string (Timestamp format)

항목이 생성된 날짜입니다(ISO 8601 형식).
lastUpdateDate

string (Timestamp format)

항목이 마지막으로 업데이트된 날짜입니다(ISO 8601 형식).
googleExpirationDate

string (Timestamp format)

상품이 만료되는 날짜입니다(ISO 8601 형식).

DestinationStatus

제품 상태의 도착 상태입니다.

JSON 표현 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
필드
reportingContext

enum (ReportingContextEnum)

보고 컨텍스트의 이름입니다.
approvedCountries[]

string

혜택이 승인된 국가 코드 (ISO 3166-1 alpha-2) 목록입니다.
pendingCountries[]

string

혜택이 승인 대기 중인 국가 코드 (ISO 3166-1 alpha-2) 목록입니다.
disapprovedCountries[]

string

혜택이 승인되지 않은 국가 코드 (ISO 3166-1 alpha-2) 목록

ItemLevelIssue

제품 상태의 ItemLevelIssue입니다.

JSON 표현 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
필드
code

string

문제의 오류 코드입니다.
severity

enum (Severity)

이 문제가 혜택 게재에 미치는 영향
resolution

string

판매자가 문제를 해결할 수 있는지 여부
attribute

string

문제가 단일 속성으로 인해 발생한 경우 속성의 이름
reportingContext

enum (ReportingContextEnum)

문제가 적용되는 보고 컨텍스트입니다.
description

string

간단한 문제 설명(영어)
detail

string

자세한 문제 설명(영어)
documentation

string

이 문제를 해결하는 데 도움이 되는 웹 페이지의 URL
applicableCountries[]

string

제품에 문제가 적용되는 국가 코드 (ISO 3166-1 alpha-2) 목록입니다.

심각도

이 문제가 제품 게재에 미치는 영향

열거형
SEVERITY_UNSPECIFIED 지정되지 않음
NOT_IMPACTED 이 문제는 경고를 나타내며 제품에 직접적인 영향을 미치지 않습니다.
DEMOTED 제품이 강등되었으며 검색 결과에서 실적이 제한될 가능성이 큽니다.
DISAPPROVED 문제로 인해 제품이 비승인됩니다.

메서드

get

 판매자 센터 계정에서 처리된 제품을 가져옵니다.

list

 판매자 센터 계정에서 처리된 제품을 표시합니다.