Package google.shopping.merchant.datasources.v1beta

색인

DataSourcesService

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

CreateDataSource

rpc CreateDataSource(CreateDataSourceRequest) returns (DataSource)

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

승인 범위

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

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

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

DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

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

승인 범위

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

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

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

FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

가져오기 일정이 아닐 때도 판매자 센터 계정의 데이터 소스에서 즉시 데이터 가져오기를 수행합니다. 이 메서드를 하루에 두 번 이상 호출해야 하는 경우 대신 제품 서비스를 사용하여 제품 데이터를 업데이트해야 합니다. 이 방법은 파일 입력 세트가 있는 데이터 소스에서만 작동합니다.

승인 범위

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

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

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

GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

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

승인 범위

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

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

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

ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

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

승인 범위

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

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

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

UpdateDataSource

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

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

승인 범위

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

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

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

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

필수 항목입니다. 프로모션 데이터 소스

입력

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

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

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

이러한 유형의 데이터 소스는 이 API를 통해 만들거나 업데이트할 수 없으며 판매자 센터 UI로만 가능합니다.

이 유형의 데이터 소스는 읽기 전용입니다.

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

DeleteDataSourceRequest

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

입력란
name

string

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

FetchDataSourceRequest

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

입력란
name

string

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

FileInput

파일 데이터 소스별 데이터입니다. 다른 데이터 소스 입력의 경우 이 필드가 비어 있습니다.

입력란
fetch_settings

FetchSettings

선택사항입니다. 세부정보를 가져와 데이터 소스를 전송합니다. FETCHGOOGLE_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 url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]에 대한 사용자 이름(선택사항)입니다. SFTP를 통해 데이터 소스를 제출하는 데 사용됩니다.

password

string

선택사항입니다. [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

string

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

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 두 글자 언어입니다.

PrimaryProductDataSource

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

입력란
channel

Channel

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

countries[]

string

선택사항입니다. 항목을 표시할 수 있는 국가입니다. CLDR 지역 코드로 표시됩니다.

feed_label

string

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

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

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

제품 콘텐츠 유형의 데이터 소스에 대해 feedLabelcontentLanguage를 모두 설정하거나 설정하지 않아야 합니다. 파일 입력이 있는 데이터 소스에 설정해야 합니다.

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

content_language

string

선택사항입니다. 변경할 수 없습니다. 데이터 소스에 있는 항목의 두 글자 ISO 639-1 언어입니다.

feedLabelcontentLanguage를 모두 설정하거나 설정하지 않아야 합니다. 파일 입력이 없는 데이터 소스에 대해서만 필드를 설정 해제할 수 있습니다.

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

채널

데이터 소스 채널

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

열거형
CHANNEL_UNSPECIFIED 지정되지 않았습니다.
ONLINE_PRODUCTS 온라인 제품.
LOCAL_PRODUCTS 오프라인 제품.
PRODUCTS 오프라인 및 온라인 제품 모두에 대한 통합 데이터 소스

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

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

입력란
feed_label

string

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

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

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

제품 콘텐츠 유형의 데이터 소스에 대해 feedLabelcontentLanguage를 모두 설정하거나 설정하지 않아야 합니다. 파일 입력이 있는 데이터 소스에 설정해야 합니다.

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

content_language

string

선택사항입니다. 변경할 수 없습니다. 데이터 소스에 있는 항목의 두 글자 ISO 639-1 언어입니다.

feedLabelcontentLanguage를 모두 설정하거나 설정하지 않아야 합니다. 파일 입력이 없는 데이터 소스에 대해서만 필드를 설정 해제할 수 있습니다.

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

UpdateDataSourceRequest

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

입력란
data_source

DataSource

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

update_mask

FieldMask

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

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

전체 데이터 소스 대체를 위해 특별한 '*' 값을 제공하는 것은 지원되지 않습니다.