REST Resource: accounts.dataSources

리소스: DataSource

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

JSON 표현
{
  "name": string,
  "dataSourceId": string,
  "displayName": string,
  "input": enum (Input),
  "fileInput": {
    object (FileInput)
  },

  // Union field Type can be only one of the following:
  "primaryProductDataSource": {
    object (PrimaryProductDataSource)
  },
  "supplementalProductDataSource": {
    object (SupplementalProductDataSource)
  },
  "localInventoryDataSource": {
    object (LocalInventoryDataSource)
  },
  "regionalInventoryDataSource": {
    object (RegionalInventoryDataSource)
  },
  "promotionDataSource": {
    object (PromotionDataSource)
  }
  // End of list of possible types for union field Type.
}
필드
name

string

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

dataSourceId

string (int64 format)

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

displayName

string

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

input

enum (Input)

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

fileInput

object (FileInput)

선택사항입니다. 이 필드는 데이터를 통해 데이터를 관리하는 경우에만 사용됩니다.

통합 필드 Type. 데이터 소스 유형입니다. Type은 다음 중 하나여야 합니다.
primaryProductDataSource

object (PrimaryProductDataSource)

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

supplementalProductDataSource

object (SupplementalProductDataSource)

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

localInventoryDataSource

object (LocalInventoryDataSource)

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

regionalInventoryDataSource

object (RegionalInventoryDataSource)

필수 항목입니다. 지역 인벤토리 데이터 소스입니다.

promotionDataSource

object (PromotionDataSource)

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

PrimaryProductDataSource

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

JSON 표현
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "feedLabel": string,
  "contentLanguage": string
}
필드
channel

enum (Channel)

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

countries[]

string

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

feedLabel

string

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

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

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

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

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

contentLanguage

string

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

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

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

채널

데이터 소스 채널

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

열거형
CHANNEL_UNSPECIFIED 지정되지 않음
ONLINE_PRODUCTS 온라인 제품.
LOCAL_PRODUCTS 오프라인 제품.
PRODUCTS 오프라인 및 온라인 제품 모두에 대한 통합 데이터 소스 참고: 이 채널에서는 API를 통해 제품을 관리할 수 없습니다.

SupplementalProductDataSource

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

JSON 표현
{
  "feedLabel": string,
  "contentLanguage": string
}
필드
feedLabel

string

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

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

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

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

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

contentLanguage

string

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

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

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

LocalInventoryDataSource

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

JSON 표현
{
  "feedLabel": string,
  "contentLanguage": string
}
필드
feedLabel

string

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

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

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

contentLanguage

string

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

RegionalInventoryDataSource

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

JSON 표현
{
  "feedLabel": string,
  "contentLanguage": string
}
필드
feedLabel

string

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

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

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

contentLanguage

string

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

PromotionDataSource

프로모션 데이터 소스입니다.

JSON 표현
{
  "targetCountry": string,
  "contentLanguage": string
}
필드
targetCountry

string

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

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

contentLanguage

string

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

입력

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

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

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

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

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

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

FileInput

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

JSON 표현
{
  "fetchSettings": {
    object (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
필드
fetchSettings

object (FetchSettings)

선택사항입니다. 세부정보를 가져와 데이터 소스를 전송합니다. FETCHGOOGLE_SHEETS 파일 입력 유형에 관한 설정을 포함합니다. 필수 입력란은 가져오기 빈도에 따라 다릅니다.

fileName

string

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

fileInputType

enum (FileInputType)

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

FetchSettings

세부정보를 가져와 데이터 소스를 전송합니다.

JSON 표현
{
  "enabled": boolean,
  "dayOfMonth": integer,
  "timeOfDay": {
    object (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
필드
enabled

boolean

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

dayOfMonth

integer

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

timeOfDay

object (TimeOfDay)

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

dayOfWeek

enum (DayOfWeek)

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

timeZone

string

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

frequency

enum (Frequency)

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

fetchUri

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를 통해 데이터 소스를 제출하는 데 사용됩니다.

TimeOfDay

하루 중 특정 시간을 나타냅니다. 날짜와 시간대가 중요하지 않거나 아무 곳으로 지정됩니다. API는 윤초를 허용하도록 선택할 수 있습니다. 관련된 유형은 google.type.Dategoogle.protobuf.Timestamp입니다.

JSON 표현
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
필드
hours

integer

24시간 형식의 시간입니다. 0~23 사이의 값이어야 합니다. API는 비즈니스 종료 시간과 같은 시나리오에서 '24:00:00' 값을 허용하도록 선택할 수 있습니다.

minutes

integer

특정 시간의 분입니다. 0~59 사이의 값이어야 합니다.

seconds

integer

특정 분의 초입니다. 일반적으로 0~59 사이의 값이어야 합니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다.

nanos

integer

나노초 단위의 초수입니다. 0~999,999,999 사이의 값이어야 합니다.

DayOfWeek

요일을 나타냅니다.

열거형
DAY_OF_WEEK_UNSPECIFIED 요일이 지정되지 않습니다.
MONDAY 월요일
TUESDAY 화요일
WEDNESDAY 수요일
THURSDAY 목요일
FRIDAY 금요일
SATURDAY 토요일
SUNDAY 일요일

빈도

필수 입력란은 가져오기 빈도에 따라 다릅니다. 월별 가져오기 일정의 경우 [날짜][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 구성된 [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]에서 파일을 가져옵니다.
GOOGLE_SHEETS [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]에 지정된 Google 스프레드시트에서 파일을 가져옵니다.

메서드

create

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

delete

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

fetch

가져오기 일정이 아닐 때도 판매자 센터 계정의 데이터 소스에서 즉시 데이터 가져오기를 수행합니다.

get

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

list

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

patch

기존 데이터 소스 구성을 업데이트합니다.