Package google.shopping.merchant.datasources.v1beta

색인

DataSourcesService

기본, 보조, 인벤토리, 기타 데이터 소스를 관리하는 서비스입니다. 자세한 내용은 판매자 센터 도움말을 참고하세요.

CreateDataSource

rpc CreateDataSource(CreateDataSourceRequest) returns (DataSource)

지정된 계정의 새 데이터 소스 구성을 만듭니다.

승인 범위

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

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

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

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

판매자 센터 계정에서 데이터 소스를 삭제합니다.

승인 범위

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

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

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

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

판매자 센터 계정의 데이터 소스에서 가져오기 일정과 관계없이 즉시 데이터 가져오기를 실행합니다. 이 메서드를 하루에 두 번 이상 호출해야 하는 경우 Products 서비스를 사용하여 제품 데이터를 업데이트해야 합니다. 이 메서드는 파일 입력이 설정된 데이터 소스에서만 작동합니다.

승인 범위

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

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

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

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

지정된 계정의 데이터 소스 구성을 가져옵니다.

승인 범위

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

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

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

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

지정된 계정의 데이터 소스 구성을 나열합니다.

승인 범위

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

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

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

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

기존 데이터 소스 구성을 업데이트합니다. 업데이트 마스크에 설정되었지만 리소스에 제공되지 않은 필드는 삭제됩니다.

승인 범위

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

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

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

FileUploadsService

데이터 소스 파일 업로드를 관리하는 서비스입니다.

GetFileUpload

rpc GetFileUpload(GetFileUploadRequest) returns (FileUpload)

최신 데이터 소스 파일 업로드를 가져옵니다. 파일 업로드에는 latest 별칭만 허용됩니다.

승인 범위

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

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

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

CreateDataSourceRequest

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

필드
parent

string

필수 항목입니다. 이 데이터 소스가 생성될 계정입니다. 형식: accounts/{account}
data_source

DataSource

필수 항목입니다. 만들려는 데이터 소스입니다.

DataSource

판매자 센터 계정의 데이터 소스입니다.

필드
name

string

식별자. 데이터 소스의 이름입니다. 형식: {datasource.name=accounts/{account}/dataSources/{datasource}}
data_source_id

int64

출력 전용입니다. 데이터 소스 ID입니다.
display_name

string

필수 항목입니다. 판매자 센터 UI에 표시되는 데이터 소스 이름입니다.
input

Input

출력 전용입니다. 데이터 소스에 대한 입력 유형을 결정합니다. 입력한 내용에 따라 일부 설정이 작동하지 않을 수 있습니다. API를 통해서는 일반 데이터 소스만 만들 수 있습니다.
file_input

FileInput

선택사항입니다. 이 필드는 데이터가 파일을 통해 관리되는 경우에만 사용됩니다.
통합 필드 Type. 필수 항목입니다. 데이터 소스 유형입니다. Type은 다음 중 하나여야 합니다.
primary_product_data_source

PrimaryProductDataSource

오프라인 및 온라인 제품의 기본 데이터 소스입니다.
supplemental_product_data_source

SupplementalProductDataSource

오프라인 및 온라인 제품의 보조 데이터 소스입니다.
local_inventory_data_source

LocalInventoryDataSource

오프라인 판매점 인벤토리 데이터 소스입니다.
regional_inventory_data_source

RegionalInventoryDataSource

지역 인벤토리 데이터 소스입니다.
promotion_data_source

PromotionDataSource

프로모션 데이터 소스
product_review_data_source

ProductReviewDataSource

제품 리뷰 데이터 소스
merchant_review_data_source

MerchantReviewDataSource

판매자 리뷰 데이터 소스입니다.

입력

데이터 소스의 입력 유형을 결정합니다. 입력에 따라 일부 설정이 지원되지 않을 수 있습니다.

열거형
INPUT_UNSPECIFIED 입력이 지정되지 않았습니다.
API 데이터가 주로 API를 통해 제공되는 데이터 소스를 나타냅니다.
FILE 데이터가 주로 파일 입력을 통해 제공되는 데이터 소스를 나타냅니다. API를 통해 데이터를 계속 제공할 수 있습니다.
UI

판매자 센터에 직접 추가된 제품의 데이터 소스입니다.

이 유형의 데이터 소스는 이 API를 통해 만들거나 업데이트할 수 없으며 판매자 센터 UI를 통해서만 만들거나 업데이트할 수 있습니다.

이 유형의 데이터 소스는 읽기 전용입니다.
AUTOFEED 제품 데이터를 자동으로 구축하는 데 사용되는 자동 피드라고도 합니다. 이 유형의 데이터 소스는 계정 번들을 통해 사용 설정 또는 중지할 수 있습니다.

DataSourceReference

데이터 소스 참조는 데이터 소스 서비스 내에서 관련 데이터 소스를 관리하는 데 사용할 수 있습니다.

필드

통합 필드 data_source_id.

data_source_id는 다음 중 하나여야 합니다.
self

bool

Self는 기본 데이터 소스 자체를 참조하는 데 사용해야 합니다.
primary_data_source_name

string

선택사항입니다. 기본 데이터 소스의 이름입니다. 형식: accounts/{account}/dataSources/{datasource}
supplemental_data_source_name

string

선택사항입니다. 보조 데이터 소스의 이름입니다. 형식: accounts/{account}/dataSources/{datasource}

DeleteDataSourceRequest

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

필드
name

string

필수 항목입니다. 삭제할 데이터 소스의 이름입니다. 형식: accounts/{account}/dataSources/{datasource}

FetchDataSourceRequest

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

필드
name

string

필수 항목입니다. 가져올 데이터 소스 리소스의 이름입니다. 형식: accounts/{account}/dataSources/{datasource}

FileInput

파일 데이터 소스에 관한 데이터입니다. 다른 데이터 소스 입력의 경우 이 필드는 비어 있습니다.

필드
fetch_settings

FetchSettings

선택사항입니다. 데이터 소스를 전송하기 위한 세부정보를 가져옵니다. FETCH 및 GOOGLE_SHEETS 파일 입력 유형에 대한 설정이 포함되어 있습니다. 필수 입력란은 가져오기 빈도에 따라 다릅니다.
file_name

string

선택사항입니다. 데이터 소스의 파일 이름입니다. UPLOAD 파일 입력 유형에 필요합니다.
file_input_type

FileInputType

출력 전용입니다. 파일 입력 유형입니다.

FetchSettings

데이터 소스를 전송하기 위한 세부정보를 가져옵니다.

필드
enabled

bool

선택사항입니다. 가져오기 일정을 사용 설정하거나 일시중지합니다.
day_of_month

int32

선택사항입니다. 데이터 소스 파일을 가져와야 하는 날짜 (1~31)입니다. 이 필드는 월간 빈도에만 설정할 수 있습니다.
time_of_day

TimeOfDay

선택사항입니다. 데이터 소스 파일을 가져와야 하는 시간입니다. 분과 초는 지원되지 않으며 무시됩니다.
day_of_week

DayOfWeek

선택사항입니다. 데이터 소스 파일을 가져와야 하는 요일입니다. 이 필드는 주간 게재빈도에만 설정할 수 있습니다.
time_zone

string

선택사항입니다. 일정에 사용되는 시간대입니다. 기본값은 UTC입니다. 예: 'America/Los_Angeles'
frequency

Frequency

필수 항목입니다. 가져오기 일정을 설명하는 빈도입니다.
fetch_uri

string

선택사항입니다. 데이터 소스 파일을 가져올 수 있는 URL입니다. Google 판매자 센터는 HTTP, HTTPS 또는 SFTP 프로토콜을 사용하여 자동 예약된 업로드를 지원하므로 값은 이러한 세 가지 프로토콜 중 하나를 사용하는 유효한 링크여야 합니다. Google Sheets 파일의 경우 변경할 수 없습니다.
username

string

선택사항입니다. fetch_uri의 사용자 이름(선택사항)입니다. SFTP를 통해 데이터 소스를 제출하는 데 사용됩니다.
password

string

선택사항입니다. fetch_uri의 비밀번호(선택사항)입니다. 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_SHEETS 파일은 fetch_uri에 지정된 Google Sheets에서 가져옵니다.

FileUpload

특정 데이터 소스의 파일 업로드입니다. 즉, 데이터 소스 처리가 완료될 때 비동기식으로 계산된 특정 타임스탬프의 데이터 소스 검색 결과입니다. 파일 데이터 소스에만 적용됩니다.

필드
name

string

식별자. 데이터 소스 파일 업로드의 이름입니다. 형식: {datasource.name=accounts/{account}/dataSources/{datasource}/fileUploads/{fileupload}}
data_source_id

int64

출력 전용입니다. 데이터 소스 ID입니다.
processing_state

ProcessingState

출력 전용입니다. 데이터 소스의 처리 상태입니다.
issues[]

Issue

출력 전용입니다. 데이터 소스에서 발생한 문제 목록
items_total

int64

출력 전용입니다. 데이터 소스에서 처리된 항목 수입니다.
items_created

int64

출력 전용입니다. 생성된 데이터 소스의 항목 수입니다.
items_updated

int64

출력 전용입니다. 데이터 소스에서 업데이트된 항목 수입니다.
upload_time

Timestamp

출력 전용입니다. 데이터 소스 파일이 업로드된 날짜입니다.

문제

'잘못된 가격'과 같은 데이터 소스에서 발생하는 오류입니다.

필드
title

string

출력 전용입니다. 문제의 제목입니다(예: '상품이 너무 큼').
description

string

출력 전용입니다. 오류 설명(예: '데이터 소스에 속성이 너무 많거나 너무 큰 항목이 있습니다. 이러한 항목은 삭제됩니다.'라는 메시지가 표시됩니다.
code

string

출력 전용입니다. 오류 코드입니다(예: 'validation/invalid_value'). 코드를 알 수 없는 경우 '?'를 반환합니다.
count

int64

출력 전용입니다. 파일 업로드에서 오류가 발생한 횟수입니다.
severity

Severity

출력 전용입니다. 문제의 심각도입니다.
documentation_uri

string

출력 전용입니다. 문제를 자세히 설명하는 문서 링크(있는 경우)

심각도

문제의 심각도입니다.

열거형
SEVERITY_UNSPECIFIED 심각도가 지정되지 않았습니다.
WARNING 문제는 경고입니다.
ERROR 이 문제는 오류입니다.

ProcessingState

데이터 소스의 처리 상태입니다.

열거형
PROCESSING_STATE_UNSPECIFIED 처리 상태가 지정되지 않았습니다.
FAILED 데이터 소스를 처리할 수 없거나 모든 항목에 오류가 있습니다.
IN_PROGRESS 데이터 소스가 처리되고 있습니다.
SUCCEEDED 일부 항목에 오류가 있었을 수 있지만 데이터 소스가 처리되었습니다.

GetDataSourceRequest

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

필드
name

string

필수 항목입니다. 검색할 데이터 소스의 이름입니다. 형식: accounts/{account}/dataSources/{datasource}

GetFileUploadRequest

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

필드
name

string

필수 항목입니다. 검색할 데이터 소스 파일 업로드의 이름입니다. 형식: accounts/{account}/dataSources/{datasource}/fileUploads/latest

ListDataSourcesRequest

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

필드
parent

string

필수 항목입니다. 데이터 소스를 나열할 계정입니다. 형식: accounts/{account}
page_size

int32

선택사항입니다. 반환할 최대 데이터 소스 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다. 지정하지 않으면 최대 데이터 소스 수가 반환됩니다.
page_token

string

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

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

ListDataSourcesResponse

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

필드
data_sources[]

DataSource

지정된 계정의 데이터 소스입니다.
next_page_token

string

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

LocalInventoryDataSource

오프라인 판매점 인벤토리 데이터 소스입니다.

필드
feed_label

string

필수 항목입니다. 변경할 수 없습니다. 오프라인 판매점 인벤토리가 제공되는 제품의 피드 라벨입니다.

대문자(A~Z), 숫자(0~9), 하이픈(-)을 포함하며 20자(영문 기준) 이하여야 합니다.

피드 라벨로의 이전도 참고하세요.
content_language

string

필수 항목입니다. 변경할 수 없습니다. 오프라인 판매점 인벤토리가 제공되는 상품의 ISO 639-1 언어(두 글자)입니다.

MerchantReviewDataSource

이 유형에는 필드가 없습니다.

판매자 리뷰 데이터 소스입니다.

PrimaryProductDataSource

오프라인 및 온라인 제품의 기본 데이터 소스입니다.

필드
channel

Channel

필수 항목입니다. 변경할 수 없습니다. 데이터 소스 채널의 유형을 지정합니다.
countries[]

string

선택사항입니다. 상품이 표시될 수 있는 국가입니다. CLDR 지역 코드로 표시됩니다.
default_rule

DefaultRule

선택사항입니다. 데이터 소스의 기본 규칙 관리 이 옵션을 설정하면 연결된 데이터 소스가 대체됩니다.
feed_label

string

선택사항입니다. 변경할 수 없습니다. 데이터 소스 수준에서 지정된 피드 라벨입니다.

대문자(A~Z), 숫자(0~9), 대시(-)를 포함하며 20자(영문 기준) 이하여야 합니다.

피드 라벨로의 이전도 참고하세요.

제품 콘텐츠 유형이 있는 데이터 소스의 경우 feedLabel 및 contentLanguage를 모두 설정하거나 모두 해제해야 합니다. 파일 입력이 있는 데이터 소스에 설정해야 합니다.

이 값을 설정하면 데이터 소스는 이 조합과 일치하는 제품만 허용합니다. 설정하지 않으면 데이터 소스는 이러한 제한이 없는 제품을 허용합니다.
content_language

string

선택사항입니다. 변경할 수 없습니다. 데이터 소스의 상품의 ISO 639-1 언어(두 글자)입니다.

feedLabel와 contentLanguage는 모두 설정되거나 모두 설정 해제되어야 합니다. 파일 입력이 없는 데이터 소스의 경우만 필드를 설정 해제할 수 있습니다.

이 값을 설정하면 데이터 소스는 이 조합과 일치하는 제품만 허용합니다. 설정하지 않으면 데이터 소스는 이러한 제한이 없는 제품을 허용합니다.

채널

데이터 소스 채널

채널은 다양한 제품 카테고리의 데이터 소스를 구분하는 데 사용됩니다.

열거형
CHANNEL_UNSPECIFIED 지정되지 않음
ONLINE_PRODUCTS 온라인 제품
LOCAL_PRODUCTS 오프라인 제품
PRODUCTS 오프라인 및 온라인 제품을 위한 통합 데이터 소스입니다. 참고: 이 채널에서는 API를 통한 제품 관리가 불가능합니다.

DefaultRule

데이터 소스의 기본 규칙 관리

필드
take_from_data_sources[]

DataSourceReference

필수 항목입니다. 기본 규칙에 연결된 데이터 소스 목록입니다. 이 목록은 데이터 조인의 기본 규칙 우선순위에 따라 정렬됩니다. self 및 보조 데이터 소스에 대한 참조가 없거나 여러 개 포함될 수 있습니다.

목록은 비워 둘 수 없습니다.

데이터 소스를 기본 규칙에 연결하려면 이 목록에 새 참조를 순차적으로 추가해야 합니다.

기본 규칙에서 데이터 소스의 연결을 해제하려면 이 목록에서 지정된 참조를 삭제해야 합니다.

이 목록의 순서를 변경하면 기본 규칙에서 데이터 소스의 우선순위가 변경됩니다.

예를 들어 [1001, self] 목록을 제공하면 보조 데이터 소스 1001에서 속성 값을 가져오고 1001에서 속성이 설정되지 않은 경우 self로 대체됩니다.

ProductReviewDataSource

이 유형에는 필드가 없습니다.

제품 리뷰 데이터 소스입니다.

PromotionDataSource

프로모션 데이터 소스

필드
target_country

string

필수 항목입니다. 변경할 수 없습니다. 고유 식별자의 일부로 사용되는 대상 국가입니다. CLDR 지역 코드로 표시됩니다.

프로모션은 일부 국가에서만 제공됩니다.
content_language

string

필수 항목입니다. 변경할 수 없습니다. 데이터 소스의 상품의 ISO 639-1 언어 코드(두 글자)입니다.

RegionalInventoryDataSource

지역 인벤토리 데이터 소스입니다.

필드
feed_label

string

필수 항목입니다. 변경할 수 없습니다. 지역 인벤토리가 제공되는 제품의 피드 라벨입니다.

대문자(A~Z), 숫자(0~9), 대시(-)를 포함하며 20자(영문 기준) 이하여야 합니다.

피드 라벨로의 이전도 참고하세요.
content_language

string

필수 항목입니다. 변경할 수 없습니다. 지역 인벤토리가 제공되는 상품의 ISO 639-1 언어(두 글자)입니다.

SupplementalProductDataSource

오프라인 및 온라인 제품의 보조 데이터 소스입니다. 생성 후 보조 제품 데이터 소스를 하나 이상의 기본 제품 데이터 소스에 연결해야 합니다.

필드
referencing_primary_data_sources[]

DataSourceReference

출력 전용입니다. 기본 또는 맞춤 규칙에서 이 데이터 소스에 연결된 모든 기본 데이터 소스의 목록 (순서가 지정되지 않고 중복 삭제됨)입니다. 모든 연결이 삭제되기 전에는 보조 데이터 소스를 삭제할 수 없습니다.
feed_label

string

선택사항입니다. 변경할 수 없습니다. 데이터 소스 수준에서 지정된 피드 라벨입니다.

대문자(A~Z), 숫자(0~9), 하이픈(-)을 포함하며 20자(영문 기준) 이하여야 합니다.

피드 라벨로의 이전도 참고하세요.

제품 콘텐츠 유형이 있는 데이터 소스의 경우 feedLabel 및 contentLanguage를 모두 설정하거나 모두 해제해야 합니다.

file input가 있는 데이터 소스에 설정해야 합니다. file input가 없는 데이터 소스의 경우 필드를 설정 해제해야 합니다.

이 값을 설정하면 데이터 소스는 이 조합과 일치하는 제품만 허용합니다. 설정하지 않으면 데이터 소스는 이러한 제한사항이 없는 제품을 허용합니다.
content_language

string

선택사항입니다. 변경할 수 없습니다. 데이터 소스의 상품의 ISO 639-1 언어(두 글자)입니다.

feedLabel와 contentLanguage는 모두 설정되거나 모두 설정 해제되어야 합니다. 파일 입력이 없는 데이터 소스의 경우만 필드를 설정 해제할 수 있습니다.

이 값을 설정하면 데이터 소스는 이 조합과 일치하는 제품만 허용합니다. 설정하지 않으면 데이터 소스는 이러한 제한사항이 없는 제품을 허용합니다.

UpdateDataSourceRequest

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

필드
data_source

DataSource

필수 항목입니다. 업데이트할 데이터 소스 리소스입니다.
update_mask

FieldMask

필수 항목입니다. 업데이트할 데이터 소스 필드 목록입니다.

본문에 지정된 값이 없는 업데이트 마스크에 지정된 필드는 데이터 소스에서 삭제됩니다.

전체 데이터 소스 교체에 특수 '*' 값을 제공하는 것은 지원되지 않습니다.