색인
DataSourcesService(인터페이스)FileUploadsService(인터페이스)CreateDataSourceRequest(메시지)DataSource(메시지)DataSource.Input(열거형)DataSourceReference(메시지)DeleteDataSourceRequest(메시지)FetchDataSourceRequest(메시지)FileInput(메시지)FileInput.FetchSettings(메시지)FileInput.FetchSettings.Frequency(열거형)FileInput.FileInputType(열거형)FileUpload(메시지)FileUpload.Issue(메시지)FileUpload.Issue.Severity(열거형)FileUpload.ProcessingState(열거형)GetDataSourceRequest(메시지)GetFileUploadRequest(메시지)ListDataSourcesRequest(메시지)ListDataSourcesResponse(메시지)LocalInventoryDataSource(메시지)MerchantReviewDataSource(메시지)PrimaryProductDataSource(메시지)PrimaryProductDataSource.Channel(열거형)PrimaryProductDataSource.DefaultRule(메시지)ProductReviewDataSource(메시지)PromotionDataSource(메시지)RegionalInventoryDataSource(메시지)SupplementalProductDataSource(메시지)UpdateDataSourceRequest(메시지)
DataSourcesService
기본, 보조, 인벤토리, 기타 데이터 소스를 관리하는 서비스입니다. 자세한 내용은 판매자 센터 도움말을 참고하세요.
| CreateDataSource |
|---|
|
지정된 계정의 새 데이터 소스 구성을 만듭니다.
|
| DeleteDataSource |
|---|
|
판매자 센터 계정에서 데이터 소스를 삭제합니다.
|
| FetchDataSource |
|---|
|
판매자 센터 계정의 데이터 소스에서 가져오기 일정과 관계없이 즉시 데이터 가져오기를 실행합니다. 이 메서드를 하루에 두 번 이상 호출해야 하는 경우 Products 서비스를 사용하여 제품 데이터를 업데이트해야 합니다. 이 메서드는 파일 입력이 설정된 데이터 소스에서만 작동합니다.
|
| GetDataSource |
|---|
|
지정된 계정의 데이터 소스 구성을 가져옵니다.
|
| ListDataSources |
|---|
|
지정된 계정의 데이터 소스 구성을 나열합니다.
|
| UpdateDataSource |
|---|
|
기존 데이터 소스 구성을 업데이트합니다. 업데이트 마스크에 설정되었지만 리소스에 제공되지 않은 필드는 삭제됩니다.
|
FileUploadsService
데이터 소스 파일 업로드를 관리하는 서비스입니다.
| GetFileUpload |
|---|
|
최신 데이터 소스 파일 업로드를 가져옵니다. 파일 업로드에는
|
CreateDataSourceRequest
CreateDataSource 메서드의 요청 메시지입니다.
| 필드 | |
|---|---|
parent |
필수 항목입니다. 이 데이터 소스가 생성될 계정입니다. 형식: |
data_ |
필수 항목입니다. 만들려는 데이터 소스입니다. |
DataSource
판매자 센터 계정의 데이터 소스입니다.
| 필드 | |
|---|---|
name |
식별자. 데이터 소스의 이름입니다. 형식: |
data_ |
출력 전용입니다. 데이터 소스 ID입니다. |
display_ |
필수 항목입니다. 판매자 센터 UI에 표시되는 데이터 소스 이름입니다. |
input |
출력 전용입니다. 데이터 소스에 대한 입력 유형을 결정합니다. 입력한 내용에 따라 일부 설정이 작동하지 않을 수 있습니다. API를 통해서는 일반 데이터 소스만 만들 수 있습니다. |
file_ |
선택사항입니다. 이 필드는 데이터가 파일을 통해 관리되는 경우에만 사용됩니다. |
통합 필드 Type. 필수 항목입니다. 데이터 소스 유형입니다. Type은 다음 중 하나여야 합니다. |
|
primary_ |
오프라인 및 온라인 제품의 기본 데이터 소스입니다. |
supplemental_ |
오프라인 및 온라인 제품의 보조 데이터 소스입니다. |
local_ |
오프라인 판매점 인벤토리 데이터 소스입니다. |
regional_ |
지역 인벤토리 데이터 소스입니다. |
promotion_ |
프로모션 데이터 소스 |
product_ |
제품 리뷰 데이터 소스 |
merchant_ |
판매자 리뷰 데이터 소스입니다. |
입력
데이터 소스의 입력 유형을 결정합니다. 입력에 따라 일부 설정이 지원되지 않을 수 있습니다.
| 열거형 | |
|---|---|
INPUT_UNSPECIFIED |
입력이 지정되지 않았습니다. |
API |
데이터가 주로 API를 통해 제공되는 데이터 소스를 나타냅니다. |
FILE |
데이터가 주로 파일 입력을 통해 제공되는 데이터 소스를 나타냅니다. API를 통해 데이터를 계속 제공할 수 있습니다. |
UI |
판매자 센터에 직접 추가된 제품의 데이터 소스입니다. 이 유형의 데이터 소스는 이 API를 통해 만들거나 업데이트할 수 없으며 판매자 센터 UI를 통해서만 만들거나 업데이트할 수 있습니다. 이 유형의 데이터 소스는 읽기 전용입니다. |
AUTOFEED |
제품 데이터를 자동으로 구축하는 데 사용되는 자동 피드라고도 합니다. 이 유형의 데이터 소스는 계정 번들을 통해 사용 설정 또는 중지할 수 있습니다. |
DataSourceReference
데이터 소스 참조는 데이터 소스 서비스 내에서 관련 데이터 소스를 관리하는 데 사용할 수 있습니다.
| 필드 | |
|---|---|
통합 필드
|
|
self |
Self는 기본 데이터 소스 자체를 참조하는 데 사용해야 합니다. |
primary_ |
선택사항입니다. 기본 데이터 소스의 이름입니다. 형식: |
supplemental_ |
선택사항입니다. 보조 데이터 소스의 이름입니다. 형식: |
DeleteDataSourceRequest
DeleteDataSource 메서드의 요청 메시지입니다.
| 필드 | |
|---|---|
name |
필수 항목입니다. 삭제할 데이터 소스의 이름입니다. 형식: |
FetchDataSourceRequest
FetchDataSource 메서드의 요청 메시지입니다.
| 필드 | |
|---|---|
name |
필수 항목입니다. 가져올 데이터 소스 리소스의 이름입니다. 형식: |
FileInput
파일 데이터 소스에 관한 데이터입니다. 다른 데이터 소스 입력의 경우 이 필드는 비어 있습니다.
| 필드 | |
|---|---|
fetch_ |
선택사항입니다. 데이터 소스를 전송하기 위한 세부정보를 가져옵니다. |
file_ |
선택사항입니다. 데이터 소스의 파일 이름입니다. |
file_ |
출력 전용입니다. 파일 입력 유형입니다. |
FetchSettings
데이터 소스를 전송하기 위한 세부정보를 가져옵니다.
| 필드 | |
|---|---|
enabled |
선택사항입니다. 가져오기 일정을 사용 설정하거나 일시중지합니다. |
day_ |
선택사항입니다. 데이터 소스 파일을 가져와야 하는 날짜 (1~31)입니다. 이 필드는 월간 빈도에만 설정할 수 있습니다. |
time_ |
선택사항입니다. 데이터 소스 파일을 가져와야 하는 시간입니다. 분과 초는 지원되지 않으며 무시됩니다. |
day_ |
선택사항입니다. 데이터 소스 파일을 가져와야 하는 요일입니다. 이 필드는 주간 게재빈도에만 설정할 수 있습니다. |
time_ |
선택사항입니다. 일정에 사용되는 시간대입니다. 기본값은 UTC입니다. 예: 'America/Los_Angeles' |
frequency |
필수 항목입니다. 가져오기 일정을 설명하는 빈도입니다. |
fetch_ |
선택사항입니다. 데이터 소스 파일을 가져올 수 있는 URL입니다. Google 판매자 센터는 HTTP, HTTPS 또는 SFTP 프로토콜을 사용하여 자동 예약된 업로드를 지원하므로 값은 이러한 세 가지 프로토콜 중 하나를 사용하는 유효한 링크여야 합니다. Google Sheets 파일의 경우 변경할 수 없습니다. |
username |
선택사항입니다. |
password |
선택사항입니다. |
빈도
필수 입력란은 가져오기 빈도에 따라 다릅니다. 월별 가져오기 일정의 경우 [일][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] 및 [시간][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] 이 필요합니다. 주간 가져오기 일정의 경우 [요일][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] 및 [시간][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] 이 필요합니다. 일일 가져오기 일정의 경우 [시간][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] 만 필요합니다.
| 열거형 | |
|---|---|
FREQUENCY_UNSPECIFIED |
빈도가 지정되지 않았습니다. |
FREQUENCY_DAILY |
가져오기는 매일 실행됩니다. |
FREQUENCY_WEEKLY |
가져오기는 매주 실행됩니다. |
FREQUENCY_MONTHLY |
가져오기는 매월 실행됩니다. |
FileInputType
파일 전송 방법입니다.
| 열거형 | |
|---|---|
FILE_INPUT_TYPE_UNSPECIFIED |
파일 입력 유형이 지정되지 않았습니다. |
UPLOAD |
파일은 SFTP, Google Cloud Storage를 통해 또는 판매자 센터에서 수동으로 업로드됩니다. |
FETCH |
파일은 구성된 fetch_uri에서 가져옵니다. |
GOOGLE_SHEETS |
파일은 fetch_uri에 지정된 Google Sheets에서 가져옵니다. |
FileUpload
특정 데이터 소스의 파일 업로드입니다. 즉, 데이터 소스 처리가 완료될 때 비동기식으로 계산된 특정 타임스탬프의 데이터 소스 검색 결과입니다. 파일 데이터 소스에만 적용됩니다.
| 필드 | |
|---|---|
name |
식별자. 데이터 소스 파일 업로드의 이름입니다. 형식: |
data_ |
출력 전용입니다. 데이터 소스 ID입니다. |
processing_ |
출력 전용입니다. 데이터 소스의 처리 상태입니다. |
issues[] |
출력 전용입니다. 데이터 소스에서 발생한 문제 목록 |
items_ |
출력 전용입니다. 데이터 소스에서 처리된 항목 수입니다. |
items_ |
출력 전용입니다. 생성된 데이터 소스의 항목 수입니다. |
items_ |
출력 전용입니다. 데이터 소스에서 업데이트된 항목 수입니다. |
upload_ |
출력 전용입니다. 데이터 소스 파일이 업로드된 날짜입니다. |
문제
'잘못된 가격'과 같은 데이터 소스에서 발생하는 오류입니다.
| 필드 | |
|---|---|
title |
출력 전용입니다. 문제의 제목입니다(예: '상품이 너무 큼'). |
description |
출력 전용입니다. 오류 설명(예: '데이터 소스에 속성이 너무 많거나 너무 큰 항목이 있습니다. 이러한 항목은 삭제됩니다.'라는 메시지가 표시됩니다. |
code |
출력 전용입니다. 오류 코드입니다(예: 'validation/invalid_value'). 코드를 알 수 없는 경우 '?'를 반환합니다. |
count |
출력 전용입니다. 파일 업로드에서 오류가 발생한 횟수입니다. |
severity |
출력 전용입니다. 문제의 심각도입니다. |
documentation_ |
출력 전용입니다. 문제를 자세히 설명하는 문서 링크(있는 경우) |
심각도
문제의 심각도입니다.
| 열거형 | |
|---|---|
SEVERITY_UNSPECIFIED |
심각도가 지정되지 않았습니다. |
WARNING |
문제는 경고입니다. |
ERROR |
이 문제는 오류입니다. |
ProcessingState
데이터 소스의 처리 상태입니다.
| 열거형 | |
|---|---|
PROCESSING_STATE_UNSPECIFIED |
처리 상태가 지정되지 않았습니다. |
FAILED |
데이터 소스를 처리할 수 없거나 모든 항목에 오류가 있습니다. |
IN_PROGRESS |
데이터 소스가 처리되고 있습니다. |
SUCCEEDED |
일부 항목에 오류가 있었을 수 있지만 데이터 소스가 처리되었습니다. |
GetDataSourceRequest
GetDataSource 메서드의 요청 메시지입니다.
| 필드 | |
|---|---|
name |
필수 항목입니다. 검색할 데이터 소스의 이름입니다. 형식: |
GetFileUploadRequest
GetFileUploadRequest 메서드의 요청 메시지입니다.
| 필드 | |
|---|---|
name |
필수 항목입니다. 검색할 데이터 소스 파일 업로드의 이름입니다. 형식: |
ListDataSourcesRequest
ListDataSources 메서드의 요청 메시지입니다.
| 필드 | |
|---|---|
parent |
필수 항목입니다. 데이터 소스를 나열할 계정입니다. 형식: |
page_ |
선택사항입니다. 반환할 최대 데이터 소스 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다. 지정하지 않으면 최대 데이터 소스 수가 반환됩니다. |
page_ |
선택사항입니다. 이전 페이지를 매길 때 |
ListDataSourcesResponse
ListDataSources 메서드의 응답 메시지입니다.
| 필드 | |
|---|---|
data_ |
지정된 계정의 데이터 소스입니다. |
next_ |
다음 페이지를 검색하기 위해 |
LocalInventoryDataSource
오프라인 판매점 인벤토리 데이터 소스입니다.
| 필드 | |
|---|---|
feed_ |
필수 항목입니다. 변경할 수 없습니다. 오프라인 판매점 인벤토리가 제공되는 제품의 피드 라벨입니다. 대문자(A~Z), 숫자(0~9), 하이픈(-)을 포함하며 20자(영문 기준) 이하여야 합니다. 피드 라벨로의 이전도 참고하세요. |
content_ |
필수 항목입니다. 변경할 수 없습니다. 오프라인 판매점 인벤토리가 제공되는 상품의 ISO 639-1 언어(두 글자)입니다. |
MerchantReviewDataSource
이 유형에는 필드가 없습니다.
판매자 리뷰 데이터 소스입니다.
PrimaryProductDataSource
오프라인 및 온라인 제품의 기본 데이터 소스입니다.
| 필드 | |
|---|---|
channel |
필수 항목입니다. 변경할 수 없습니다. 데이터 소스 채널의 유형을 지정합니다. |
countries[] |
선택사항입니다. 상품이 표시될 수 있는 국가입니다. CLDR 지역 코드로 표시됩니다. |
default_ |
선택사항입니다. 데이터 소스의 기본 규칙 관리 이 옵션을 설정하면 연결된 데이터 소스가 대체됩니다. |
feed_ |
선택사항입니다. 변경할 수 없습니다. 데이터 소스 수준에서 지정된 피드 라벨입니다. 대문자(A~Z), 숫자(0~9), 대시(-)를 포함하며 20자(영문 기준) 이하여야 합니다. 피드 라벨로의 이전도 참고하세요. 제품 콘텐츠 유형이 있는 데이터 소스의 경우 이 값을 설정하면 데이터 소스는 이 조합과 일치하는 제품만 허용합니다. 설정하지 않으면 데이터 소스는 이러한 제한이 없는 제품을 허용합니다. |
content_ |
선택사항입니다. 변경할 수 없습니다. 데이터 소스의 상품의 ISO 639-1 언어(두 글자)입니다.
이 값을 설정하면 데이터 소스는 이 조합과 일치하는 제품만 허용합니다. 설정하지 않으면 데이터 소스는 이러한 제한이 없는 제품을 허용합니다. |
채널
데이터 소스 채널
채널은 다양한 제품 카테고리의 데이터 소스를 구분하는 데 사용됩니다.
| 열거형 | |
|---|---|
CHANNEL_UNSPECIFIED |
지정되지 않음 |
ONLINE_PRODUCTS |
온라인 제품 |
LOCAL_PRODUCTS |
오프라인 제품 |
PRODUCTS |
오프라인 및 온라인 제품을 위한 통합 데이터 소스입니다. 참고: 이 채널에서는 API를 통한 제품 관리가 불가능합니다. |
DefaultRule
데이터 소스의 기본 규칙 관리
| 필드 | |
|---|---|
take_ |
필수 항목입니다. 기본 규칙에 연결된 데이터 소스 목록입니다. 이 목록은 데이터 조인의 기본 규칙 우선순위에 따라 정렬됩니다. 목록은 비워 둘 수 없습니다. 데이터 소스를 기본 규칙에 연결하려면 이 목록에 새 참조를 순차적으로 추가해야 합니다. 기본 규칙에서 데이터 소스의 연결을 해제하려면 이 목록에서 지정된 참조를 삭제해야 합니다. 이 목록의 순서를 변경하면 기본 규칙에서 데이터 소스의 우선순위가 변경됩니다. 예를 들어 [ |
ProductReviewDataSource
이 유형에는 필드가 없습니다.
제품 리뷰 데이터 소스입니다.
PromotionDataSource
프로모션 데이터 소스
| 필드 | |
|---|---|
target_ |
필수 항목입니다. 변경할 수 없습니다. 고유 식별자의 일부로 사용되는 대상 국가입니다. CLDR 지역 코드로 표시됩니다. 프로모션은 일부 국가에서만 제공됩니다. |
content_ |
필수 항목입니다. 변경할 수 없습니다. 데이터 소스의 상품의 ISO 639-1 언어 코드(두 글자)입니다. |
RegionalInventoryDataSource
지역 인벤토리 데이터 소스입니다.
| 필드 | |
|---|---|
feed_ |
필수 항목입니다. 변경할 수 없습니다. 지역 인벤토리가 제공되는 제품의 피드 라벨입니다. 대문자(A~Z), 숫자(0~9), 대시(-)를 포함하며 20자(영문 기준) 이하여야 합니다. 피드 라벨로의 이전도 참고하세요. |
content_ |
필수 항목입니다. 변경할 수 없습니다. 지역 인벤토리가 제공되는 상품의 ISO 639-1 언어(두 글자)입니다. |
SupplementalProductDataSource
오프라인 및 온라인 제품의 보조 데이터 소스입니다. 생성 후 보조 제품 데이터 소스를 하나 이상의 기본 제품 데이터 소스에 연결해야 합니다.
| 필드 | |
|---|---|
referencing_ |
출력 전용입니다. 기본 또는 맞춤 규칙에서 이 데이터 소스에 연결된 모든 기본 데이터 소스의 목록 (순서가 지정되지 않고 중복 삭제됨)입니다. 모든 연결이 삭제되기 전에는 보조 데이터 소스를 삭제할 수 없습니다. |
feed_ |
선택사항입니다. 변경할 수 없습니다. 데이터 소스 수준에서 지정된 피드 라벨입니다. 대문자(A~Z), 숫자(0~9), 하이픈(-)을 포함하며 20자(영문 기준) 이하여야 합니다. 피드 라벨로의 이전도 참고하세요. 제품 콘텐츠 유형이 있는 데이터 소스의 경우
이 값을 설정하면 데이터 소스는 이 조합과 일치하는 제품만 허용합니다. 설정하지 않으면 데이터 소스는 이러한 제한사항이 없는 제품을 허용합니다. |
content_ |
선택사항입니다. 변경할 수 없습니다. 데이터 소스의 상품의 ISO 639-1 언어(두 글자)입니다.
이 값을 설정하면 데이터 소스는 이 조합과 일치하는 제품만 허용합니다. 설정하지 않으면 데이터 소스는 이러한 제한사항이 없는 제품을 허용합니다. |
UpdateDataSourceRequest
UpdateDataSource 메서드의 요청 메시지입니다.
| 필드 | |
|---|---|
data_ |
필수 항목입니다. 업데이트할 데이터 소스 리소스입니다. |
update_ |
필수 항목입니다. 업데이트할 데이터 소스 필드 목록입니다. 본문에 지정된 값이 없는 업데이트 마스크에 지정된 필드는 데이터 소스에서 삭제됩니다. 전체 데이터 소스 교체에 특수 '*' 값을 제공하는 것은 지원되지 않습니다. |