색인
DataSourcesService
(인터페이스)CreateDataSourceRequest
(메시지)DataSource
(메시지)DataSource.Input
(열거형)DeleteDataSourceRequest
(메시지)FetchDataSourceRequest
(메시지)FileInput
(메시지)FileInput.FetchSettings
(메시지)FileInput.FetchSettings.Frequency
(열거형)FileInput.FileInputType
(열거형)GetDataSourceRequest
(메시지)ListDataSourcesRequest
(메시지)ListDataSourcesResponse
(메시지)LocalInventoryDataSource
(메시지)PrimaryProductDataSource
(메시지)PrimaryProductDataSource.Channel
(열거형)PromotionDataSource
(메시지)RegionalInventoryDataSource
(메시지)SupplementalProductDataSource
(메시지)UpdateDataSourceRequest
(메시지)
DataSourcesService
기본, 보조, 인벤토리, 기타 데이터 소스를 관리하는 서비스 자세한 내용은 판매자 센터 도움말을 참조하세요.
CreateDataSource |
---|
지정된 계정의 새 데이터 소스 구성을 만듭니다.
|
DeleteDataSource |
---|
판매자 센터 계정에서 데이터 소스를 삭제합니다.
|
FetchDataSource |
---|
가져오기 일정이 아닐 때도 판매자 센터 계정의 데이터 소스에서 즉시 데이터 가져오기를 수행합니다. 이 메서드를 하루에 두 번 이상 호출해야 하는 경우 대신 제품 서비스를 사용하여 제품 데이터를 업데이트해야 합니다. 이 방법은 파일 입력 세트가 있는 데이터 소스에서만 작동합니다.
|
GetDataSource |
---|
지정된 계정의 데이터 소스 구성을 가져옵니다.
|
ListDataSources |
---|
지정된 계정의 데이터 소스 구성을 나열합니다.
|
UpdateDataSource |
---|
기존 데이터 소스 구성을 업데이트합니다. 업데이트 마스크에 설정되었지만 리소스에 제공되지 않은 필드는 삭제됩니다.
|
CreateDataSourceRequest
CreateDataSource 메서드의 요청 메시지입니다.
필드 | |
---|---|
parent |
필수 항목입니다. 이 데이터 소스가 생성될 계정입니다. 형식: |
data_source |
필수 항목입니다. 생성할 데이터 소스입니다. |
DataSource
판매자 센터 계정의 데이터 소스입니다.
필드 | |
---|---|
name |
식별자. 데이터 소스의 이름입니다. 형식: |
data_source_id |
출력 전용입니다. 데이터 소스 ID입니다. |
display_name |
필수 항목입니다. 판매자 센터 UI에 표시되는 데이터 소스 이름입니다. |
input |
출력 전용입니다. 데이터 소스에 대한 입력 유형을 결정합니다. 입력한 정보에 따라 일부 설정이 작동하지 않을 수 있습니다. API를 통해 일반 데이터 소스만 만들 수 있습니다. |
file_input |
선택사항입니다. 이 필드는 데이터를 통해 데이터를 관리하는 경우에만 사용됩니다. |
통합 필드 Type . 데이터 소스 유형입니다. Type 은 다음 중 하나여야 합니다. |
|
primary_product_data_source |
필수 항목입니다. 오프라인 및 온라인 제품의 기본 데이터 소스입니다. |
supplemental_product_data_source |
필수 항목입니다. 오프라인 및 온라인 제품의 보조 데이터 소스입니다. |
local_inventory_data_source |
필수 항목입니다. 오프라인 판매점 인벤토리 데이터 소스입니다. |
regional_inventory_data_source |
필수 항목입니다. 지역 인벤토리 데이터 소스입니다. |
promotion_data_source |
필수 항목입니다. 프로모션 데이터 소스 |
입력
데이터 소스에 대한 입력 유형을 결정합니다. 입력한 내용에 따라 일부 설정이 지원되지 않을 수 있습니다.
열거형 | |
---|---|
INPUT_UNSPECIFIED |
입력이 지정되지 않았습니다. |
API |
데이터가 주로 API를 통해 제공되는 데이터 소스를 나타냅니다. |
FILE |
데이터가 주로 파일 입력을 통해 제공되는 데이터 소스를 나타냅니다. 데이터는 API를 통해 계속 제공될 수 있습니다. |
UI |
판매자 센터에서 직접 추가된 제품의 데이터 소스입니다. 이러한 유형의 데이터 소스는 이 API를 통해 만들거나 업데이트할 수 없으며 판매자 센터 UI로만 가능합니다. 이 유형의 데이터 소스는 읽기 전용입니다. |
AUTOFEED |
제품 데이터를 자동으로 생성하는 데 사용되는 자동 피드라고도 합니다. 이 유형의 데이터 소스는 계정 번들을 통해 사용 설정하거나 사용 중지할 수 있습니다. |
DeleteDataSourceRequest
DeleteDataSource 메서드의 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 삭제할 데이터 소스의 이름입니다. 형식: |
FetchDataSourceRequest
FetchDataSource 메서드의 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 가져올 데이터 소스 리소스의 이름입니다. 형식: |
FileInput
파일 데이터 소스별 데이터입니다. 다른 데이터 소스 입력의 경우 이 필드가 비어 있습니다.
필드 | |
---|---|
fetch_settings |
선택사항입니다. 세부정보를 가져와 데이터 소스를 전송합니다. |
file_name |
선택사항입니다. 데이터 소스의 파일 이름입니다. |
file_input_type |
출력 전용입니다. 파일 입력 유형입니다. |
FetchSettings
세부정보를 가져와 데이터 소스를 전송합니다.
필드 | |
---|---|
enabled |
선택사항입니다. 가져오기 일정을 사용 설정하거나 일시중지합니다. |
day_of_month |
선택사항입니다. 데이터 소스 파일을 가져와야 하는 날짜입니다 (1~31). 이 필드는 월간 빈도로만 설정할 수 있습니다. |
time_of_day |
선택사항입니다. 데이터 소스 파일을 가져와야 하는 시간입니다. 분과 초는 지원되지 않으며 무시됩니다. |
day_of_week |
선택사항입니다. 데이터 소스 파일을 가져와야 하는 요일입니다. 이 필드는 주간 빈도로만 설정할 수 있습니다. |
time_zone |
선택사항입니다. 일정에 사용되는 시간대. 기본값은 UTC입니다. 예: 'America/Los_Angeles' |
frequency |
필수 항목입니다. 가져오기 일정을 설명하는 빈도입니다. |
fetch_uri |
선택사항입니다. 데이터 소스 파일을 가져올 수 있는 URL입니다. Google 판매자 센터는 HTTP, HTTPS 또는 SFTP 프로토콜을 사용하여 자동 예약 업로드를 지원하므로 값은 세 가지 프로토콜 중 하나를 사용하는 유효한 링크여야 합니다. Google Sheets 파일의 경우 변경할 수 없습니다. |
username |
선택사항입니다. [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]에 대한 사용자 이름(선택사항)입니다. SFTP를 통해 데이터 소스를 제출하는 데 사용됩니다. |
password |
선택사항입니다. [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]의 비밀번호(선택사항)입니다. SFTP를 통해 데이터 소스를 제출하는 데 사용됩니다. |
빈도
필수 입력란은 가져오기 빈도에 따라 다릅니다. 월별 가져오기 일정의 경우 [날짜][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.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]에서 파일을 가져옵니다. |
GOOGLE_SHEETS |
[fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]에 지정된 Google 스프레드시트에서 파일을 가져옵니다. |
GetDataSourceRequest
GetDataSource 메서드의 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 검색할 데이터 소스의 이름입니다. 형식: |
ListDataSourcesRequest
ListDataSources 메서드의 요청 메시지입니다.
필드 | |
---|---|
parent |
필수 항목입니다. 데이터 소스를 나열할 계정입니다. 형식: |
page_size |
선택사항입니다. 반환할 데이터 소스의 최대 개수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다. 지정하지 않으면 최대 데이터 소스 수가 반환됩니다. |
page_token |
선택사항입니다. 이전 페이지를 매길 때 |
ListDataSourcesResponse
ListDataSources 메서드의 응답 메시지입니다.
필드 | |
---|---|
data_sources[] |
지정된 계정의 데이터 소스입니다. |
next_page_token |
다음 페이지를 검색하기 위해 |
LocalInventoryDataSource
오프라인 판매점 인벤토리 데이터 소스입니다.
필드 | |
---|---|
feed_label |
필수 항목입니다. 변경할 수 없습니다. 오프라인 판매점 인벤토리가 제공된 제품의 피드 라벨입니다. 대문자(A~Z), 숫자(0~9), 대시(-)는 20자(영문 기준) 이하여야 합니다. 피드 라벨로 이전도 참고하세요. |
content_language |
필수 항목입니다. 변경할 수 없습니다. 오프라인 판매점 인벤토리가 제공되는 상품의 ISO 639-1 두 자리 언어입니다. |
PrimaryProductDataSource
오프라인 및 온라인 제품의 기본 데이터 소스입니다.
필드 | |
---|---|
channel |
필수 항목입니다. 변경할 수 없습니다. 데이터 소스 채널의 유형을 지정합니다. |
countries[] |
선택사항입니다. 항목을 표시할 수 있는 국가입니다. CLDR 지역 코드로 표시됩니다. |
feed_label |
선택사항입니다. 변경할 수 없습니다. 데이터 소스 수준에서 지정된 피드 라벨입니다. 대문자(A~Z), 숫자(0~9), 대시(-)는 20자(영문 기준) 이하여야 합니다. 피드 라벨로 이전도 참고하세요. 제품 콘텐츠 유형의 데이터 소스에 대해 설정되면 데이터 소스는 이 조합과 일치하는 제품만 허용합니다. 설정하지 않으면 데이터 소스에서 이러한 제한 없이 제품을 허용합니다. |
content_language |
선택사항입니다. 변경할 수 없습니다. 데이터 소스에 있는 항목의 두 글자 ISO 639-1 언어입니다.
설정되면 데이터 소스는 이 조합과 일치하는 제품만 허용합니다. 설정하지 않으면 데이터 소스에서 이러한 제한 없이 제품을 허용합니다. |
채널
데이터 소스 채널
채널은 여러 제품 카테고리의 데이터 소스를 구분하는 데 사용됩니다.
열거형 | |
---|---|
CHANNEL_UNSPECIFIED |
지정되지 않음 |
ONLINE_PRODUCTS |
온라인 제품. |
LOCAL_PRODUCTS |
오프라인 제품. |
PRODUCTS |
오프라인 및 온라인 제품 모두에 대한 통합 데이터 소스 참고: 이 채널에서는 API를 통해 제품을 관리할 수 없습니다. |
PromotionDataSource
프로모션 데이터 소스입니다.
필드 | |
---|---|
target_country |
필수 항목입니다. 변경할 수 없습니다. 고유 식별자의 일부로 사용되는 대상 국가입니다. CLDR 지역 코드로 표시됩니다. 프로모션은 일부 국가에서만 제공됩니다. |
content_language |
필수 항목입니다. 변경할 수 없습니다. 데이터 소스에 있는 항목의 두 글자 ISO 639-1 언어입니다. |
RegionalInventoryDataSource
지역 인벤토리 데이터 소스입니다.
필드 | |
---|---|
feed_label |
필수 항목입니다. 변경할 수 없습니다. 지역 인벤토리가 제공된 제품의 피드 라벨입니다. 대문자(A~Z), 숫자(0~9), 대시(-)는 20자(영문 기준) 이하여야 합니다. 피드 라벨로 이전도 참고하세요. |
content_language |
필수 항목입니다. 변경할 수 없습니다. 지역 인벤토리가 제공되는 상품의 ISO 639-1 두 자리 언어입니다. |
SupplementalProductDataSource
오프라인 및 온라인 제품의 보조 데이터 소스입니다.
필드 | |
---|---|
feed_label |
선택사항입니다. 변경할 수 없습니다. 데이터 소스 수준에서 지정된 피드 라벨입니다. 대문자(A~Z), 숫자(0~9), 대시(-)는 20자(영문 기준) 이하여야 합니다. 피드 라벨로 이전도 참고하세요. 제품 콘텐츠 유형의 데이터 소스에 대해 설정되면 데이터 소스는 이 조합과 일치하는 제품만 허용합니다. 설정하지 않으면 데이터 소스에서 이러한 제한 없이 제품을 허용합니다. |
content_language |
선택사항입니다. 변경할 수 없습니다. 데이터 소스에 있는 항목의 두 글자 ISO 639-1 언어입니다.
설정되면 데이터 소스는 이 조합과 일치하는 제품만 허용합니다. 설정하지 않으면 데이터 소스에서 이러한 제한 없이 제품을 허용합니다. |
UpdateDataSourceRequest
UpdateDataSource 메서드의 요청 메시지입니다.
필드 | |
---|---|
data_source |
필수 항목입니다. 업데이트할 데이터 소스 리소스입니다. |
update_mask |
필수 항목입니다. 업데이트할 데이터 소스 필드의 목록입니다. 본문에 지정된 값 없이 업데이트 마스크에 지정된 필드는 데이터 소스에서 삭제됩니다. 특수 '*' 표시 전체 데이터 소스 대체 값은 지원되지 않습니다. |