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)
  },
  "productReviewDataSource": {
    object (ProductReviewDataSource)
  },
  "merchantReviewDataSource": {
    object (MerchantReviewDataSource)
  }
  // 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)

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

object (ProductReviewDataSource)

필수 항목입니다. 제품 리뷰 데이터 소스
merchantReviewDataSource

object (MerchantReviewDataSource)

필수 항목입니다. 판매자 리뷰 데이터 소스입니다.

PrimaryProductDataSource

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

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

enum (Channel)

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

string

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

object (DefaultRule)

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

string

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

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

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

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

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

string

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

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

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

채널

데이터 소스 채널

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

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

DefaultRule

데이터 소스의 기본 규칙 관리입니다.

JSON 표현 
{
  "takeFromDataSources": [
    {
      object (DataSourceReference)
    }
  ]
}
필드
takeFromDataSources[]

object (DataSourceReference)

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

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

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

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

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

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

DataSourceReference

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

JSON 표현 
{

  // Union field data_source_id can be only one of the following:
  "self": boolean,
  "primaryDataSourceName": string,
  "supplementalDataSourceName": string
  // End of list of possible types for union field data_source_id.
}
필드

통합 필드 data_source_id.

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

boolean

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

string

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

string

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

SupplementalProductDataSource

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

JSON 표현 
{
  "referencingPrimaryDataSources": [
    {
      object (DataSourceReference)
    }
  ],
  "feedLabel": string,
  "contentLanguage": string
}
필드
referencingPrimaryDataSources[]

object (DataSourceReference)

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

string

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

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

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

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

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

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

string

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

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

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

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

ProductReviewDataSource

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

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

MerchantReviewDataSource

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

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

입력

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

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

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

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

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

FileInput

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

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

object (FetchSettings)

선택사항입니다. 데이터 소스를 전송하기 위한 세부정보를 가져옵니다. FETCH 및 GOOGLE_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

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

string

선택사항입니다. fetchUri의 비밀번호(선택사항)입니다. SFTP를 통해 데이터 소스를 제출하는 데 사용됩니다.

TimeOfDay

하루 중 특정 시간을 나타냅니다. 날짜와 시간대가 중요하지 않거나 아무 곳으로 지정됩니다. API는 윤초를 허용하도록 선택할 수 있습니다. 관련된 유형은 google.type.Date 및 google.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

1분의 초입니다. 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_SHEETS 파일은 fetchUri에 지정된 Google Sheets에서 가져옵니다.

메서드

create

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

delete

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

fetch

 판매자 센터 계정의 데이터 소스에서 가져오기 일정과 관계없이 즉시 데이터 가져오기를 실행합니다.

get

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

list

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

patch

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