이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Package google.shopping.merchant.products.v1beta

색인

ProductInputsService(인터페이스)
ProductsService(인터페이스)
Attributes(메시지)
Certification(메시지)
CloudExportAdditionalProperties(메시지)
DeleteProductInputRequest(메시지)
FreeShippingThreshold(메시지)
GetProductRequest(메시지)
InsertProductInputRequest(메시지)
Installment(메시지)
ListProductsRequest(메시지)
ListProductsResponse(메시지)
LoyaltyPoints(메시지)
LoyaltyProgram(메시지)
Product(메시지)
ProductDetail(메시지)
ProductDimension(메시지)
ProductInput(메시지)
ProductStatus(메시지)
ProductStatus.DestinationStatus(메시지)
ProductStatus.ItemLevelIssue(메시지)
ProductStatus.ItemLevelIssue.Severity(열거형)
ProductStructuredDescription(메시지)
ProductStructuredTitle(메시지)
ProductSustainabilityIncentive(메시지)
ProductSustainabilityIncentive.Type(열거형)
ProductWeight(메시지)
Shipping(메시지)
ShippingDimension(메시지)
ShippingWeight(메시지)
SubscriptionCost(메시지)
SubscriptionPeriod(열거형)
Tax(메시지)
UnitPricingBaseMeasure(메시지)
UnitPricingMeasure(메시지)

ProductInputsService

ProductInput 리소스를 사용하는 서비스입니다. 이 서비스는 온라인 채널이 있는 제품에만 사용할 수 있습니다.

DeleteProductInput

DeleteProductInput
`rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)` 판매자 센터 계정에서 제품 입력을 삭제합니다. 제품 입력을 삽입, 업데이트 또는 삭제한 후 처리된 제품을 검색할 수 있기까지 몇 분 정도 걸릴 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. `https://www.googleapis.com/auth/content` 자세한 내용은 OAuth 2.0 Overview를 참고하세요.

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

판매자 센터 계정에서 제품 입력을 삭제합니다.

제품 입력을 삽입, 업데이트 또는 삭제한 후 처리된 제품을 검색할 수 있기까지 몇 분 정도 걸릴 수 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 Overview를 참고하세요.

InsertProductInput

InsertProductInput
`rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)` 판매자 센터 계정에 제품 입력을 업로드합니다. contentLanguage, offerId, dataSource가 동일한 입력이 이미 있는 경우 이 메서드는 해당 항목을 대체합니다. 제품 입력을 삽입, 업데이트 또는 삭제한 후 처리된 제품을 검색할 수 있기까지 몇 분 정도 걸릴 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. `https://www.googleapis.com/auth/content` 자세한 내용은 OAuth 2.0 Overview를 참고하세요.

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

판매자 센터 계정에 제품 입력을 업로드합니다. contentLanguage, offerId, dataSource가 동일한 입력이 이미 있는 경우 이 메서드는 해당 항목을 대체합니다.

제품 입력을 삽입, 업데이트 또는 삭제한 후 처리된 제품을 검색할 수 있기까지 몇 분 정도 걸릴 수 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 Overview를 참고하세요.

제품 서비스

제품 리소스를 사용하는 서비스입니다. 이 서비스는 온라인 채널이 있는 제품에만 사용할 수 있습니다.

GetProduct

GetProduct
`rpc GetProduct(GetProductRequest) returns (Product)` 판매자 센터 계정에서 처리된 제품을 가져옵니다. 제품 입력을 삽입, 업데이트 또는 삭제한 후 업데이트된 최종 제품을 검색할 수 있기까지 몇 분 정도 걸릴 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. `https://www.googleapis.com/auth/content` 자세한 내용은 OAuth 2.0 Overview를 참고하세요.

rpc GetProduct(GetProductRequest) returns (Product)

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

제품 입력을 삽입, 업데이트 또는 삭제한 후 업데이트된 최종 제품을 검색할 수 있기까지 몇 분 정도 걸릴 수 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 Overview를 참고하세요.

ListProducts

ListProducts
`rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)` 판매자 센터 계정에서 처리된 제품을 표시합니다. 응답에 pageSize로 지정된 것보다 적은 항목이 포함될 수 있습니다. pageToken을 사용하여 요청할 항목이 더 있는지 확인합니다. 제품 입력을 삽입, 업데이트 또는 삭제한 후 업데이트된 처리된 제품을 검색할 수 있기까지 몇 분 정도 걸릴 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. `https://www.googleapis.com/auth/content` 자세한 내용은 OAuth 2.0 Overview를 참고하세요.

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

판매자 센터 계정에서 처리된 제품을 표시합니다. 응답에 pageSize로 지정된 것보다 적은 항목이 포함될 수 있습니다. pageToken을 사용하여 요청할 항목이 더 있는지 확인합니다.

제품 입력을 삽입, 업데이트 또는 삭제한 후 업데이트된 처리된 제품을 검색할 수 있기까지 몇 분 정도 걸릴 수 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 Overview를 참고하세요.

속성

필드
`additional_image_links[]`	`string` 상품 이미지의 추가 URL입니다.
`expiration_date`	`Timestamp` 삽입 시 지정한 대로 상품이 만료되는 날짜입니다(ISO 8601 형식). 실제 만료일은 `productstatuses`에 googleExpirationDate로 노출되며 `expirationDate`가 너무 먼 미래인 경우 더 일찍 만료될 수 있습니다.
`disclosure_date`	`Timestamp` Google의 YouTube 플랫폼 검색 결과에 제품이 표시되는 날짜 및 시간입니다(ISO 8601 형식). 자세한 내용은 [공개일]( https://support.google.com/merchants/answer/13034208)을 참고하세요.
`availability_date`	`Timestamp` 선주문 제품을 배송할 수 있는 날짜입니다. ISO 8601 형식으로 나타냅니다.
`gtin[]`	`string` 상품의 국제거래단품식별코드 (GTIN)입니다. GTIN은 최대 10개까지 제공할 수 있습니다.
`price`	`Price` 상품 가격.
`installment`	`Installment` 상품에 대한 할부 횟수 및 금액입니다.
`subscription_cost`	`SubscriptionCost` 연결된 정기 결제 계약이 있는 상품의 기간 (월 또는 연) 수 및 기간당 결제 금액입니다.
`loyalty_points`	`LoyaltyPoints` 사용자가 상품을 구매한 후 받는 적립 포인트입니다. 일본만 해당
`loyalty_programs[]`	`LoyaltyProgram` 이 상품의 사용자에게 포인트 멤버십 혜택 (예: 더 나은 가격, 포인트 등)을 표시하는 데 사용되는 포인트 멤버십 정보 목록입니다.
`product_types[]`	`string` 상품의 카테고리입니다 (제품 데이터 사양과 같은 형식).
`sale_price`	`Price` 상품의 광고된 할인가입니다.
`sale_price_effective_date`	`Interval` 상품 할인이 적용되는 기간입니다 (제품 데이터 사양 참고).
`product_height`	`ProductDimension` 제공된 단위로 표시된 제품의 높이입니다. 값은 0 (0 제외)~3,000 (3,000 포함) 사이여야 합니다.
`product_length`	`ProductDimension` 제공된 단위로 표시된 제품의 길이입니다. 값은 0 (0 제외)~3,000 (3,000 포함) 사이여야 합니다.
`product_width`	`ProductDimension` 제공된 단위로 표시된 제품의 너비입니다. 값은 0 (0 제외)~3,000 (3,000 포함) 사이여야 합니다.
`product_weight`	`ProductWeight` 제공된 단위로 표시된 제품의 중량입니다. 값은 0 (0 제외)~2000 (2000 포함) 사이여야 합니다.
`shipping[]`	`Shipping` 배송 규칙
`free_shipping_threshold[]`	`FreeShippingThreshold` 제품에 무료 배송이 적용되기 위해 충족해야 하는 조건입니다.
`shipping_weight`	`ShippingWeight` 배송할 상품의 중량입니다.
`shipping_length`	`ShippingDimension` 배송할 상품의 길이입니다.
`shipping_width`	`ShippingDimension` 배송할 상품의 너비입니다.
`shipping_height`	`ShippingDimension` 배송할 상품의 높이입니다.
`size_types[]`	`string` 상품의 컷입니다. 의류 상품의 결합된 사이즈 유형을 나타내는 데 사용할 수 있습니다. 사이즈 유형은 최대 2개까지 제공할 수 있습니다([https://support.google.com/merchants/answer/6324497](사이즈 유형) 참고).
`taxes[]`	`Tax` 세금 정보
`unit_pricing_measure`	`UnitPricingMeasure` 상품의 측정값 및 크기입니다.
`unit_pricing_base_measure`	`UnitPricingBaseMeasure` 단가의 분모에 대한 환경설정입니다.
`ads_labels[]`	`string` ads_grouping과 유사하지만 CPC에서만 작동합니다.
`cost_of_goods_sold`	`Price` 매출원가입니다. 총이익 보고에 사용됩니다.
`product_details[]`	`ProductDetail` 기술 사양 또는 추가 제품 세부정보
`product_highlights[]`	`string` 제품의 가장 관련성 높은 특징을 설명하는 글머리 기호 목록입니다.
`display_ads_similar_ids[]`	`string` 광고주가 지정한 추천
`promotion_ids[]`	`string` 프로모션의 고유 ID입니다.
`included_destinations[]`	`string` 이 타겟에 포함할 대상 유형의 목록입니다 (판매자 센터의 선택된 체크박스에 해당). `excludedDestinations`에 포함하지 않는 한 기본 대상은 항상 포함됩니다.
`excluded_destinations[]`	`string` 이 타겟에서 제외할 대상 유형의 목록입니다 (판매자 센터의 선택 해제된 체크박스에 해당).
`shopping_ads_excluded_countries[]`	`string` 쇼핑 광고 도착 페이지에서 제품을 제외할 국가 코드 (ISO 3166-1 alpha-2) 목록입니다. 이 목록에 있는 국가는 데이터 소스 설정에서 구성된 국가에서 삭제됩니다.
`lifestyle_image_links[]`	`string` 상품의 라이프스타일 이미지의 추가 URL로, 실제 환경에서 상품을 보여주는 이미지를 명시적으로 식별하는 데 사용됩니다. 자세한 내용은 고객센터 도움말을 참고하세요.
`cloud_export_additional_properties[]`	`CloudExportAdditionalProperties` Cloud Retail 프로그램으로 내보낼 추가 필드입니다.
`certifications[]`	`Certification` 제품 인증(예: EU EPREL 데이터베이스에 기록된 제품의 에너지 효율 라벨) 자세한 내용은 고객센터 도움말을 참고하세요.
`auto_pricing_min_price`	`Price` '자동 할인' (https://support.google.com/merchants/answer/10295759) 및 '동적 프로모션' (https://support.google.com/merchants/answer/13949249) 프로젝트의 보호 조치로, 판매자의 제품 할인이 이 값 아래로 떨어지지 않도록 하여 제품의 가치와 수익성을 보존합니다.
`sustainability_incentives[]`	`ProductSustainabilityIncentive` 지속 가능성 인센티브 프로그램 목록
`identifier_exists`	`bool` 상품에 카테고리에 적합한 제품 고유 식별자(예: GTIN, MPN, 브랜드)가 없는 경우 이 값을 false로 설정합니다. 제공되지 않으면 기본값은 true입니다.
`is_bundle`	`bool` 상품이 판매자 정의 번들인지 여부입니다. 번들은 판매자가 단일 가격으로 판매하는 여러 제품의 맞춤 그룹입니다.
`title`	`string` 상품 제목
`description`	`string` 상품 설명
`link`	`string` 온라인 상점의 상품 페이지로 바로 연결되는 URL입니다.
`mobile_link`	`string` 상품 방문 페이지의 모바일에 최적화된 버전의 URL입니다.
`canonical_link`	`string` 상품 방문 페이지의 표준 버전 URL입니다.
`image_link`	`string` 상품 이미지의 URL입니다.
`adult`	`bool` 상품이 성인 대상인 경우 true로 설정합니다.
`age_group`	`string` 상품의 대상 연령대입니다.
`availability`	`string` 상품의 재고 상태입니다.
`brand`	`string` 상품의 브랜드.
`color`	`string` 상품의 색상입니다.
`condition`	`string` 상품의 상태입니다.
`gender`	`string` 상품의 타겟 성별입니다.
`google_product_category`	`string` Google의 상품 카테고리입니다 (Google 상품 분류 참고). 제품을 쿼리할 때 이 필드에는 사용자가 제공한 값이 포함됩니다. 현재 API를 통해 자동으로 할당된 Google 제품 카테고리를 가져오는 방법은 없습니다.
`item_group_id`	`string` 동일한 제품의 모든 변형에 공유되는 식별자입니다.
`material`	`string` 상품을 만든 소재입니다.
`mpn`	`string` 상품의 제조업체 부품 번호 (MPN)입니다.
`pattern`	`string` 상품의 패턴 (예: 물방울무늬)
`sell_on_google_quantity`	`int64` Google에서 판매할 수 있는 제품의 수량입니다. 온라인 제품에만 지원됩니다.
`max_handling_time`	`int64` 최대 제품 준비 기간 (영업일 기준)
`min_handling_time`	`int64` 최소 제품 준비 시간 (영업일 기준)
`shipping_label`	`string` 계정 수준 배송 규칙에서 제품을 그룹화하는 데 사용되는 제품의 배송물 라벨입니다.
`transit_time_label`	`string` 계정 수준 운송 시간 표에서 제품을 그룹화하는 데 사용되는 제품의 운송 시간 라벨입니다.
`size`	`string` 상품 크기입니다. 값은 하나만 허용됩니다. 사이즈가 다른 옵션의 경우 동일한 `itemGroupId` 값을 사용하여 각 사이즈에 대해 별도의 제품을 삽입합니다([https://support.google.com/merchants/answer/6324492](사이즈 정의) 참고).
`size_system`	`string` 크기가 지정된 시스템입니다. 의류 상품에 권장됩니다.
`tax_category`	`string` 제품의 세금 카테고리입니다.
`energy_efficiency_class`	`string` EU 지침 2010/30/EU에 정의된 에너지 효율 등급입니다.
`min_energy_efficiency_class`	`string` EU 지침 2010/30/EU에 정의된 에너지 효율 등급입니다.
`max_energy_efficiency_class`	`string` EU 지침 2010/30/EU에 정의된 에너지 효율 등급입니다.
`multipack`	`int64` 판매자가 정의한 패키지 상품에 포함된 동일 제품의 수입니다.
`ads_grouping`	`string` 임의로 항목을 그룹화하는 데 사용합니다. CPA%에만 적용되며 그 외의 경우에는 권장하지 않습니다.
`ads_redirect`	`string` 광고주가 제품이 제품 광고의 맥락 내에 표시될 때 상품 URL을 재정의할 수 있습니다.
`display_ads_id`	`string` 동적 리마케팅 캠페인의 상품 식별자입니다.
`display_ads_title`	`string` 동적 리마케팅 캠페인의 상품 제목입니다.
`display_ads_link`	`string` 동적 리마케팅 캠페인을 위해 상품의 방문 페이지로 바로 연결되는 URL입니다.
`display_ads_value`	`double` 동적 리마케팅 캠페인의 제품 마진입니다.
`pickup_method`	`string` 상품의 수령 옵션입니다.
`pickup_sla`	`string` 상품 매장 수령 타임라인
`link_template`	`string` 판매자가 호스팅하는 매장 홈페이지의 링크 템플릿입니다.
`mobile_link_template`	`string` 휴대기기에 최적화된 판매자가 호스팅하는 매장 홈페이지의 링크 템플릿입니다.
`custom_label_0`	`string` 쇼핑 캠페인에서 상품을 맞춤 그룹화하기 위한 맞춤 라벨 0입니다.
`custom_label_1`	`string` 쇼핑 캠페인에서 상품을 맞춤 그룹화하기 위한 맞춤 라벨 1입니다.
`custom_label_2`	`string` 쇼핑 캠페인에서 상품을 맞춤 그룹화하기 위한 맞춤 라벨 2입니다.
`custom_label_3`	`string` 쇼핑 캠페인에서 상품을 맞춤 그룹화하기 위한 맞춤 라벨 3입니다.
`custom_label_4`	`string` 쇼핑 캠페인에서 상품을 맞춤 그룹화하기 위한 맞춤 라벨 4입니다.
`external_seller_id`	`string` 복수 판매자 계정에 필수입니다. 다중 판매자 계정에 다양한 판매자의 제품을 업로드하는 마켓인 경우 이 속성을 사용하세요.
`pause`	`string` 이 항목의 게시가 일시적으로 일시중지됩니다.
`virtual_model_link`	`string` 상품의 3D 이미지 URL입니다. 자세한 내용은 고객센터 도움말을 참고하세요.
`structured_title`	`ProductStructuredTitle` 알고리즘 (AI) 생성 제품명의 경우 구조화된 제품명
`structured_description`	`ProductStructuredDescription` 알고리즘 (AI) 생성 설명의 경우 구조화된 설명

인증

제품 인증: 처음에는 EU EPREL 데이터베이스를 사용하여 EU 에너지 효율 라벨 지정 규정을 준수하기 위해 도입되었습니다.

필드
`certification_authority`	`string` 인증 기관입니다(예: 'European_Commission'). 최대 길이는 2,000자(영문 기준)입니다.
`certification_name`	`string` 인증 이름입니다(예: 'EPREL'). 최대 길이는 2,000자(영문 기준)입니다.
`certification_code`	`string` 인증 코드 최대 길이는 2,000자(영문 기준)입니다.
`certification_value`	`string` 인증 값(클래스, 등급 또는 성적이라고도 함)입니다(예: 'A+', 'C', '골드'). 최대 길이는 2,000자(영문 기준)입니다.

CloudExportAdditionalProperties

Cloud Retail API의 제품 속성입니다. 예를 들어 TV 제품의 속성은 'Screen-Resolution' 또는 'Screen-Size'일 수 있습니다.

필드
`text_value[]`	`string` 지정된 속성의 텍스트 값입니다. 예를 들어 '8K(UHD)'는 TV 제품의 텍스트 값일 수 있습니다. 이 값의 최대 반복 횟수는 400회입니다. 값은 임의의 순서로 일관되게 저장됩니다. 최대 문자열 크기는 256자(영문 기준)입니다.
`int_value[]`	`int64` 지정된 속성의 정수 값입니다. 예를 들어 TV 제품의 화면 해상도는 1080입니다. 이 값의 최대 반복 횟수는 400회입니다. 값은 임의의 순서로 일관되게 저장됩니다.
`float_value[]`	`float` 지정된 속성의 부동 소수점 값입니다. 예를 들어 TV 제품 1.2345의 경우 이 값의 최대 반복 횟수는 400회입니다. 값은 임의의 순서로 일관되게 저장됩니다.
`property_name`	`string` 지정된 속성의 이름입니다. 예를 들어 TV 제품의 경우 'Screen-Resolution'입니다. 최대 문자열 크기는 256자(영문 기준)입니다.
`bool_value`	`bool` 지정된 속성의 불리언 값입니다. 예를 들어 TV 제품의 경우 화면이 UHD인 경우 'True' 또는 'False'입니다.
`min_value`	`float` 지정된 속성의 최소 부동 소수점 값입니다. 예를 들어 TV 제품 1.00의 경우
`max_value`	`float` 지정된 속성의 최대 부동 소수점 값입니다. 예를 들어 TV 제품의 경우 100.00입니다.
`unit_code`	`string` 지정된 속성의 단위입니다. 예를 들어 TV 제품의 경우 '픽셀'입니다. 최대 문자열 크기는 256바이트입니다.

DeleteProductInputRequest

DeleteProductInput 메서드의 요청 메시지입니다.

필드

필드
`name`	`string` 필수입니다. 삭제할 제품 입력 리소스의 이름입니다. 형식: accounts/{account}/productInputs/{product} 여기서 마지막 섹션 `product`은 4개의 부분(channel~content_language~feed_label~offer_id)으로 구성됩니다. 제품 이름의 예는 'accounts/123/productInputs/online~en~US~sku123'입니다.
`data_source`	`string` 필수입니다. 제품 입력을 삭제해야 하는 기본 또는 보조 데이터 소스입니다. 형식: `accounts/{account}/dataSources/{datasource}`

name

string

필수입니다. 삭제할 제품 입력 리소스의 이름입니다. 형식: accounts/{account}/productInputs/{product} 여기서 마지막 섹션 product은 4개의 부분(channel~content_language~feed_label~offer_id)으로 구성됩니다. 제품 이름의 예는 'accounts/123/productInputs/online~en~US~sku123'입니다.

data_source

string

필수입니다. 제품 입력을 삭제해야 하는 기본 또는 보조 데이터 소스입니다. 형식: accounts/{account}/dataSources/{datasource}

FreeShippingThreshold

제품에 무료 배송이 적용되기 위해 충족해야 하는 조건입니다.

필드

필드
`country`	`string` 상품이 배송될 국가의 CLDR 지역 코드입니다.
`price_threshold`	`Price` 배송비가 무료가 되기 위한 최소 제품 가격입니다. 숫자로 표현됩니다.

country

string

상품이 배송될 국가의 CLDR 지역 코드입니다.

price_threshold

Price

배송비가 무료가 되기 위한 최소 제품 가격입니다. 숫자로 표현됩니다.

GetProductRequest

GetProduct 메서드의 요청 메시지입니다.

필드

필드
`name`	`string` 필수입니다. 가져올 제품의 이름입니다. 형식: `accounts/{account}/products/{product}`, 여기서 마지막 섹션 `product`은 4개의 부분(channel~content_language~feed_label~offer_id)으로 구성됩니다. 제품 이름의 예는 'accounts/123/products/online~en~US~sku123'입니다.

name

string

필수입니다. 가져올 제품의 이름입니다. 형식: accounts/{account}/products/{product}, 여기서 마지막 섹션 product은 4개의 부분(channel~content_language~feed_label~offer_id)으로 구성됩니다. 제품 이름의 예는 'accounts/123/products/online~en~US~sku123'입니다.

InsertProductInputRequest

InsertProductInput 메서드의 요청 메시지입니다.

필드

필드
`parent`	`string` 필수입니다. 이 제품이 삽입될 계정입니다. 형식: accounts/{account}
`product_input`	`ProductInput` 필수입니다. 삽입할 제품 입력입니다.
`data_source`	`string` 필수입니다. 기본 또는 보조 제품 데이터 소스 이름입니다. 제품이 이미 존재하고 제공된 데이터 소스가 다른 경우 제품이 새 데이터 소스로 이동합니다. API 데이터 소스만 지원됩니다. 형식: `accounts/{account}/dataSources/{datasource}`

parent

string

필수입니다. 이 제품이 삽입될 계정입니다. 형식: accounts/{account}

product_input

ProductInput

필수입니다. 삽입할 제품 입력입니다.

data_source

string

필수입니다. 기본 또는 보조 제품 데이터 소스 이름입니다. 제품이 이미 존재하고 제공된 데이터 소스가 다른 경우 제품이 새 데이터 소스로 이동합니다.

API 데이터 소스만 지원됩니다.

형식: accounts/{account}/dataSources/{datasource}

할부

할부를 나타내는 메시지입니다.

필드
`months`	`int64` 구매자가 결제해야 하는 할부 횟수입니다.
`amount`	`Price` 구매자가 매월 결제해야 하는 금액입니다.
`downpayment`	`Price` 구매자가 선불로 지불해야 하는 계약금 금액입니다.
`credit_type`	`string` 할부 유형입니다. 지원되는 값은 다음과 같습니다. * "`finance`" * "`lease`"

ListProductsRequest

ListProducts 메서드의 요청 메시지입니다.

필드

필드
`parent`	`string` 필수입니다. 처리된 제품을 표시할 계정입니다. 형식: accounts/{account}
`page_size`	`int32` 반환할 제품의 최대 개수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 최댓값은 250이며, 250을 초과하는 값은 250으로 변환됩니다. 지정하지 않으면 최대 제품 수가 반환됩니다.
`page_token`	`string` 이전 `ListProducts` 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지를 매길 때 `ListProducts`에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

parent

string

필수입니다. 처리된 제품을 표시할 계정입니다. 형식: accounts/{account}

page_size

int32

반환할 제품의 최대 개수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 최댓값은 250이며, 250을 초과하는 값은 250으로 변환됩니다. 지정하지 않으면 최대 제품 수가 반환됩니다.

page_token

string

이전 ListProducts 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListProducts에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListProductsResponse

ListProducts 메서드의 응답 메시지입니다.

필드

필드
`products[]`	`Product` 지정된 계정에서 처리된 제품입니다. 규칙과 보조 데이터 소스를 적용한 후 처리된 제품입니다.
`next_page_token`	`string` 다음 페이지를 검색하기 위해 `page_token`으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

products[]

Product

지정된 계정에서 처리된 제품입니다. 규칙과 보조 데이터 소스를 적용한 후 처리된 제품입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

LoyaltyPoints

포인트를 나타내는 메시지입니다.

필드

필드
`name`	`string` 적립 포인트 프로그램의 이름입니다. 이름은 12자(일본어 기준) 또는 24자(영문 기준)로 제한하는 것이 좋습니다.
`points_value`	`int64` 소매업체의 충성도 포인트(절대값)입니다.
`ratio`	`double` 통화로 전환 시 포인트 비율입니다. Google은 판매자 센터 설정에 따라 통화를 가정합니다. 비율을 생략하면 기본값은 1.0입니다.

name

string

적립 포인트 프로그램의 이름입니다. 이름은 12자(일본어 기준) 또는 24자(영문 기준)로 제한하는 것이 좋습니다.

points_value

int64

소매업체의 충성도 포인트(절대값)입니다.

ratio

double

통화로 전환 시 포인트 비율입니다. Google은 판매자 센터 설정에 따라 통화를 가정합니다. 비율을 생략하면 기본값은 1.0입니다.

LoyaltyProgram

포인트 제도를 나타내는 메시지입니다.

필드
`program_label`	`string` 포인트 멤버십의 라벨입니다. 판매자 항목과 포인트 제도 항목 간의 관계를 고유하게 식별하는 내부 라벨입니다. 시스템에서 아래 애셋 (예: 가격 및 포인트)을 판매자와 연결할 수 있도록 라벨을 제공해야 합니다. 해당 프로그램이 판매자 계정에 연결되어 있어야 합니다.
`tier_label`	`string` 포인트 제도 내 등급의 라벨입니다. 프로그램 내 라벨 중 하나와 일치해야 합니다.
`price`	`Price` 특정 등급의 회원에게 적용되는 가격, 즉 즉시 할인 가격입니다. 일반 가격보다 작거나 같아야 합니다.
`cashback_for_future_use`	`Price` 향후 구매에 사용할 수 있는 캐시백
`loyalty_points`	`int64` 구매 시 적립되는 적립 포인트 수입니다.
`member_price_effective_date`	`Interval` 상품에 회원 가격이 적용되는 기간입니다. 지정하지 않으면 회원 가격이 항상 적용됩니다. 기간은 공백, 쉼표 또는 슬래시로 구분된 ISO 8601 날짜 쌍으로 표시됩니다.
`shipping_label`	`string` 배송 혜택의 라벨입니다. 이 필드에 값이 있으면 이 제품에 포인트 제도 대상 배송 혜택이 적용됩니다. 필드 값이 제공되지 않으면 해당 포인트 등급의 포인트 제도 대상 배송이 적용되지 않습니다.

제품

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

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

필드
`name`	`string` 제품 이름입니다. 형식: `"{product.name=accounts/{account}/products/{product}}"` 여기서 마지막 섹션 `product`은 4개의 부분(channel~content_language~feed_label~offer_id)으로 구성됩니다. 제품 이름의 예는 'accounts/123/products/online~en~US~sku123'입니다.
`channel`	`ChannelEnum` 출력 전용입니다. 제품의 채널입니다.
`offer_id`	`string` 출력 전용입니다. 제품의 고유 식별자입니다. 이는 제품 입력과 처리된 제품에서 동일합니다. 제출 시 선행 및 후행 공백이 제거되고 여러 공백은 단일 공백으로 대체됩니다. 자세한 내용은 제품 데이터 사양을 참고하세요.
`content_language`	`string` 출력 전용입니다. 제품의 ISO 639-1 언어 코드(두 글자)입니다.
`feed_label`	`string` 출력 전용입니다. 제품의 피드 라벨입니다.
`data_source`	`string` 출력 전용입니다. 제품의 기본 데이터 소스입니다.
`attributes`	`Attributes` 출력 전용입니다. 제품 속성 목록입니다.
`custom_attributes[]`	`CustomAttribute` 출력 전용입니다. 맞춤 (판매자 제공) 속성 목록입니다. 또한 데이터 사양의 속성을 일반 형식 (예: `{ "name": "size type", "value": "regular" }`)으로 제출하는 데 사용할 수 있습니다. 이는 Buy on Google에 사용되는 추가 속성과 같이 API에 의해 명시적으로 노출되지 않는 속성을 제출하는 데 유용합니다.
`product_status`	`ProductStatus` 출력 전용입니다. 제품 상태, 데이터 유효성 검사 문제, 즉 비동기식으로 계산된 제품에 관한 정보입니다.
`version_number`	`int64` 출력 전용입니다. 제품의 기존 버전 (최신성)을 나타냅니다. 이 버전은 여러 업데이트가 동시에 실행될 때 올바른 순서를 유지하는 데 사용할 수 있습니다. 이 속성을 설정하면 버전 번호가 기존 제품의 현재 버전 번호보다 낮은 경우 삽입이 방지됩니다. 현재 `version_number`를 사용하여 재삽입 (예: 30일 후 제품 업데이트)을 실행할 수 있습니다. 기본 데이터 소스에 삽입하는 경우에만 지원됩니다. 작업이 방지되면 중단된 예외가 발생합니다.

ProductDetail

제품 세부정보

필드

필드
`section_name`	`string` 제품 세부정보 집합을 그룹화하는 데 사용되는 섹션 헤더입니다.
`attribute_name`	`string` 제품 세부정보의 이름입니다.
`attribute_value`	`string` 제품 세부정보의 값입니다.

section_name

string

제품 세부정보 집합을 그룹화하는 데 사용되는 섹션 헤더입니다.

attribute_name

string

제품 세부정보의 이름입니다.

attribute_value

string

제품 세부정보의 값입니다.

ProductDimension

제품의 크기입니다.

필드

필드
`value`	`double` 필수입니다. 숫자로 표시된 측정기준 값입니다. 값의 최대 소수점 자릿수는 4자리입니다.
`unit`	`string` 필수입니다. 측정기준 단위입니다. 허용되는 값은 다음과 같습니다. * "`in`" * "`cm`"

value

double

필수입니다. 숫자로 표시된 측정기준 값입니다. 값의 최대 소수점 자릿수는 4자리입니다.

unit

string

필수입니다. 측정기준 단위입니다. 허용되는 값은 다음과 같습니다. * "in" * "cm"

ProductInput

이 리소스는 판매자 센터, 쇼핑 광고 또는 Google 플랫폼에 표시되는 처리된 제품이 아닌 제품에 대해 제출하는 입력 데이터를 나타냅니다. 제품 입력, 규칙, 보조 데이터 소스 데이터가 결합되어 처리된 Product가 생성됩니다.

데이터 유효성 검사를 통과하는 데 필요한 제품 입력 속성은 주로 제품 데이터 사양에 정의되어 있습니다.

feedLabel, contentLanguage, offerId 속성이 필요합니다.

제품 입력을 삽입, 업데이트 또는 삭제한 후 처리된 제품을 검색할 수 있기까지 몇 분 정도 걸릴 수 있습니다.

제품 입력란 및 하위 메시지의 모든 필드는 일부 예외를 제외하고 카테고리 사양의 해당 속성의 영어 이름과 일치합니다.

필드
`name`	`string` 식별자. 제품 입력의 이름입니다. 형식: `"{productinput.name=accounts/{account}/productInputs/{productinput}}"` 여기서 마지막 섹션 `productinput`은 4개의 부분(channel~content_language~feed_label~offer_id)으로 구성됩니다. 제품 입력 이름의 예는 'accounts/123/productInputs/online~en~US~sku123'입니다.
`product`	`string` 출력 전용입니다. 처리된 제품의 이름입니다. 형식: `"{product.name=accounts/{account}/products/{product}}"`
`channel`	`ChannelEnum` 변경할 수 없습니다. 제품의 채널입니다.
`offer_id`	`string` 필수입니다. 변경할 수 없습니다. 제품의 고유 식별자입니다. 이는 제품 입력과 처리된 제품에서 동일합니다. 제출 시 선행 및 후행 공백이 제거되고 여러 공백은 단일 공백으로 대체됩니다. 자세한 내용은 제품 데이터 사양을 참고하세요.
`content_language`	`string` 필수입니다. 변경할 수 없습니다. 제품의 ISO 639-1 언어 코드(두 글자)입니다.
`feed_label`	`string` 필수입니다. 변경할 수 없습니다. 제품의 피드 라벨입니다.
`attributes`	`Attributes` 선택사항입니다. 제품 속성 목록입니다.
`custom_attributes[]`	`CustomAttribute` 선택사항입니다. 맞춤 (판매자 제공) 속성 목록입니다. 또한 데이터 사양의 속성을 일반 형식 (예: `{ "name": "size type", "value": "regular" }`)으로 제출하는 데 사용할 수 있습니다. 이는 Buy on Google에 사용되는 추가 속성과 같이 API에 의해 명시적으로 노출되지 않는 속성을 제출하는 데 유용합니다. 각 맞춤 속성의 최대 허용 문자 수는 10,240자(영문 기준)입니다(이름과 값의 문자 수 합계를 나타냄). 제품당 최대 2, 500개의 맞춤 속성을 설정할 수 있으며 총 크기는 102.4KB입니다. 맞춤 속성 이름의 밑줄은 삽입 시 공백으로 대체됩니다.
`version_number`	`int64` 선택사항입니다. 제품의 기존 버전 (최신성)을 나타냅니다. 이 버전은 여러 업데이트가 동시에 실행될 때 올바른 순서를 유지하는 데 사용할 수 있습니다. 이 속성을 설정하면 버전 번호가 기존 제품의 현재 버전 번호보다 낮은 경우 삽입이 방지됩니다. 현재 `version_number`를 사용하여 재삽입 (예: 30일 후 제품 업데이트)을 실행할 수 있습니다. 기본 데이터 소스에 삽입하는 경우에만 지원됩니다. 작업이 방지되면 중단된 예외가 발생합니다.

ProductStatus

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

필드
`destination_statuses[]`	`DestinationStatus` 상품의 의도한 대상 위치
`item_level_issues[]`	`ItemLevelIssue` 제품과 관련된 모든 문제의 목록입니다.
`creation_date`	`Timestamp` 항목이 생성된 날짜입니다. ISO 8601 형식입니다.
`last_update_date`	`Timestamp` 항목이 마지막으로 업데이트된 날짜입니다(ISO 8601 형식).
`google_expiration_date`	`Timestamp` 상품이 만료되는 날짜입니다(ISO 8601 형식).

DestinationStatus

제품 상태의 대상 상태입니다.

필드
`reporting_context`	`ReportingContextEnum` 보고 컨텍스트의 이름입니다.
`approved_countries[]`	`string` 혜택이 승인된 국가 코드 (ISO 3166-1 alpha-2) 목록입니다.
`pending_countries[]`	`string` 혜택이 승인 대기 중인 국가 코드 (ISO 3166-1 alpha-2) 목록입니다.
`disapproved_countries[]`	`string` 혜택이 승인되지 않은 국가 코드 (ISO 3166-1 alpha-2) 목록

ItemLevelIssue

제품 상태의 ItemLevelIssue입니다.

필드
`code`	`string` 문제의 오류 코드
`severity`	`Severity` 이 문제가 혜택 제공에 미치는 영향
`resolution`	`string` 판매자가 문제를 해결할 수 있는지 여부
`attribute`	`string` 문제가 단일 속성으로 인해 발생한 경우 속성의 이름.
`reporting_context`	`ReportingContextEnum` 문제가 적용되는 보고 컨텍스트입니다.
`description`	`string` 간단한 문제 설명(영어)
`detail`	`string` 자세한 문제 설명(영어)
`documentation`	`string` 이 문제를 해결하는 데 도움이 되는 웹페이지의 URL
`applicable_countries[]`	`string` 제품에 문제가 적용되는 국가 코드 (ISO 3166-1 alpha-2) 목록입니다.

심각도

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

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

ProductStructuredDescription

구조화된 설명: 알고리즘 (AI) 생성 설명

필드

필드
`digital_source_type`	`string` 디지털 소스 유형입니다(예: 'trained_algorithmic_media'). IPTC를 팔로우 중입니다. 최대 길이는 40자(영문 기준)입니다.
`content`	`string` 설명 텍스트의 최대 길이는 5,000자(영문 기준)입니다.

digital_source_type

string

디지털 소스 유형입니다(예: 'trained_algorithmic_media'). IPTC를 팔로우 중입니다. 최대 길이는 40자(영문 기준)입니다.

content

string

설명 텍스트의 최대 길이는 5,000자(영문 기준)입니다.

ProductStructuredTitle

알고리즘 (AI) 생성 제품명의 경우 구조화된 제품명

필드

필드
`digital_source_type`	`string` 디지털 소스 유형입니다(예: 'trained_algorithmic_media'). IPTC를 팔로우 중입니다. 최대 길이는 40자(영문 기준)입니다.
`content`	`string` 제목 텍스트의 최대 길이는 150자(영문 기준)입니다.

digital_source_type

string

디지털 소스 유형입니다(예: 'trained_algorithmic_media'). IPTC를 팔로우 중입니다. 최대 길이는 40자(영문 기준)입니다.

content

string

제목 텍스트의 최대 길이는 150자(영문 기준)입니다.

ProductSustainabilityIncentive

리베이트 또는 세금 공제와 같은 지속가능성 관련 인센티브 프로그램에 관한 정보

필드
통합 필드 `value`. 지속 가능성 인센티브 값입니다. `value`은 다음 중 하나여야 합니다.
`amount`	`Price` 인센티브의 고정 금액입니다.
`percentage`	`double` 인센티브가 적용되는 할인가의 비율입니다.
`type`	`Type` 지속 가능성 인센티브 프로그램

유형

지원되는 지속 가능성 인센티브 프로그램 유형입니다.

열거형
`TYPE_UNSPECIFIED`	지정되지 않거나 알 수 없는 지속가능성 인센티브 유형입니다.
`EV_TAX_CREDIT`	전기자동차 및 일부 국가의 경우 플러그인 하이브리드에 대한 세금 납부 의무 감면을 제공하는 프로그램입니다. 이러한 할인은 특정 금액 또는 할인가의 비율을 기준으로 할 수 있습니다.
`EV_PRICE_DISCOUNT`	환경 보너스라고도 하는 보조금 프로그램은 전기 자동차 및 일부 국가의 경우 플러그인 하이브리드에 대한 구매 보조금을 제공합니다. 부여 금액은 고정 금액이거나 판매가의 일정 비율일 수 있습니다.

ProductWeight

제품의 중량입니다.

필드

필드
`value`	`double` 필수입니다. 숫자로 표시된 가중치입니다. 가중치는 소수점 이하 4자리까지 정확하게 지정할 수 있습니다.
`unit`	`string` 필수입니다. 중량 단위입니다. 허용되는 값은 다음과 같습니다. * "`g`" * "`kg`" * "`oz`" * "`lb`"

value

double

필수입니다. 숫자로 표시된 가중치입니다. 가중치는 소수점 이하 4자리까지 정확하게 지정할 수 있습니다.

unit

string

필수입니다. 중량 단위입니다. 허용되는 값은 다음과 같습니다. * "g" * "kg" * "oz" * "lb"

배송

제품 배송입니다.

필드
`price`	`Price` 고정 배송비로, 숫자로 표시됩니다.
`country`	`string` 상품이 배송될 국가의 CLDR 지역 코드입니다.
`region`	`string` 배송비 요율이 적용되는 지리적 리전입니다. 자세한 내용은 region을 참고하세요.
`service`	`string` 서비스 등급 또는 배송 속도에 대한 자유 형식의 설명입니다.
`location_id`	`int64` AdWords API에 정의된 대로 배송비가 적용되는 위치의 숫자 ID입니다.
`location_group_name`	`string` 배송이 적용되는 위치로, 위치 그룹 이름으로 표시됩니다.
`postal_code`	`string` 배송비 요율이 적용되는 우편번호 범위로, 우편번호, 우편번호 접두어 뒤에 와일드 카드(*)가 오는 경우, 두 우편번호 사이의 범위 또는 길이가 같은 두 우편번호 접두어로 표시됩니다.
`min_handling_time`	`int64` 주문 접수 시점부터 발송 시점까지의 최소 상품 준비 시간 (일 기준)입니다. 0은 주문이 마감 시간 전에 접수된 경우 주문 접수 당일에 배송됨을 의미합니다. `minHandlingTime`는 `maxHandlingTime`와 함께만 있을 수 있지만 `maxHandlingTime`가 있는 경우에는 필요하지 않습니다.
`max_handling_time`	`int64` 주문 접수 시점부터 발송 시점까지의 최대 상품 준비 시간 (일 기준)입니다. 0은 주문이 마감 시간 전에 접수된 경우 주문 접수 당일에 배송됨을 의미합니다. 배송 속도를 제공하는 경우 `maxHandlingTime` 및 `maxTransitTime`가 모두 필요합니다. `maxHandlingTime`가 있는 경우 `minHandlingTime`는 선택사항입니다.
`min_transit_time`	`int64` 주문 제품이 발송된 날짜부터 배송된 날짜까지의 최소 운송 시간 (일 기준)입니다. 0은 주문 제품이 배송된 당일에 배송됨을 의미합니다. `minTransitTime`는 `maxTransitTime`와 함께만 있을 수 있지만 `maxTransitTime`가 있는 경우에는 필요하지 않습니다.
`max_transit_time`	`int64` 주문 제품이 발송된 날짜부터 배송된 날짜까지의 최대 운송 시간 (일 기준)입니다. 0은 주문 제품이 배송된 당일에 배송됨을 의미합니다. 배송 속도를 제공하는 경우 `maxHandlingTime` 및 `maxTransitTime`가 모두 필요합니다. `maxTransitTime`가 있는 경우 `minTransitTime`는 선택사항입니다.

ShippingDimension

제품의 ShippingDimension입니다.

필드

필드
`value`	`double` 상품의 배송비를 계산하는 데 사용되는 제품의 크기입니다.
`unit`	`string` 값 단위입니다.

value

double

상품의 배송비를 계산하는 데 사용되는 제품의 크기입니다.

unit

string

값 단위입니다.

ShippingWeight

제품의 ShippingWeight입니다.

필드

필드
`value`	`double` 상품의 배송비를 계산하는 데 사용되는 제품의 중량입니다.
`unit`	`string` 값 단위입니다.

value

double

상품의 배송비를 계산하는 데 사용되는 제품의 중량입니다.

unit

string

값 단위입니다.

SubscriptionCost

제품의 SubscriptionCost입니다.

필드

필드
`period`	`SubscriptionPeriod` 구독 기간 유형입니다. 지원되는 값은 다음과 같습니다. * "`month`" * "`year`"
`period_length`	`int64` 구매자가 결제해야 하는 구독 기간의 수입니다.
`amount`	`Price` 구매자가 구독 기간당 지불해야 하는 금액입니다.

period

SubscriptionPeriod

구독 기간 유형입니다. 지원되는 값은 다음과 같습니다. * "month" * "year"

period_length

int64

구매자가 결제해야 하는 구독 기간의 수입니다.

amount

Price

구매자가 구독 기간당 지불해야 하는 금액입니다.

SubscriptionPeriod

제품의 정기 결제 기간입니다.

열거형
`SUBSCRIPTION_PERIOD_UNSPECIFIED`	구독 기간이 지정되지 않았음을 나타냅니다.
`MONTH`	정기 결제 기간이 월임을 나타냅니다.
`YEAR`	정기 결제 기간이 연도임을 나타냅니다.

세금

제품의 세금입니다.

필드
`rate`	`double` 상품 가격에 적용되는 세율의 비율입니다.
`country`	`string` 상품에 세금이 부과되는 국가로, CLDR 지역 코드로 지정됩니다.
`region`	`string` 세율이 적용되는 지리적 지역입니다.
`tax_ship`	`bool` 배송비에 세금이 부과되는 경우 true로 설정합니다.
`location_id`	`int64` AdWords API에 정의된 대로 세율이 적용되는 위치의 숫자 ID입니다.
`postal_code`	`string` 세율이 적용되는 우편번호 범위로, 우편번호, * 와일드 카드를 사용하는 우편번호 접두어, 두 우편번호 사이의 범위 또는 길이가 같은 두 우편번호 접두어로 표시됩니다. 예: 94114, 94, 94002-95460, 94-95*.

UnitPricingBaseMeasure

제품의 UnitPricingBaseMeasure입니다.

필드

필드
`value`	`int64` 단가의 분모입니다.
`unit`	`string` 분모의 단위입니다.

value

int64

단가의 분모입니다.

unit

string

분모의 단위입니다.

UnitPricingMeasure

제품의 UnitPricingMeasure입니다.

필드

필드
`value`	`double` 상품의 측정값입니다.
`unit`	`string` 측정 단위입니다.

value

double

상품의 측정값입니다.

unit

string

측정 단위입니다.