REST Resource: accounts.dataSources

Kaynak: DataSource

Merchant Center hesabının veri kaynağı.

JSON gösterimi 
{
  "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.
}
Alanlar
name

string

Tanımlayıcı. Veri kaynağının adı. Biçim: {datasource.name=accounts/{account}/dataSources/{datasource}}
dataSourceId

string (int64 format)

Yalnızca çıkış. Veri kaynağı kimliği.
displayName

string

Zorunlu. Merchant Center kullanıcı arayüzünde gösterilen veri kaynağı adı.
input

enum (Input)

Yalnızca çıkış. Veri kaynağına girilen giriş türünü belirler. Girdiğiniz bilgilere bağlı olarak bazı ayarlar çalışmayabilir. API üzerinden yalnızca genel veri kaynakları oluşturulabilir.
fileInput

object (FileInput)

İsteğe bağlıdır. Alan yalnızca veriler bir dosya üzerinden yönetildiğinde kullanılır.
Birlik alanı Type. Zorunlu. Veri kaynağı türü. Type yalnızca aşağıdakilerden biri olabilir:
primaryProductDataSource

object (PrimaryProductDataSource)

Yerel ve online ürünler için birincil veri kaynağı.
supplementalProductDataSource

object (SupplementalProductDataSource)

Yerel ve online ürünler için ek veri kaynağı.
localInventoryDataSource

object (LocalInventoryDataSource)

Yerel envanter veri kaynağı.
regionalInventoryDataSource

object (RegionalInventoryDataSource)

Bölgesel envanter veri kaynağı.
promotionDataSource

object (PromotionDataSource)

Promosyon veri kaynağı.
productReviewDataSource

object (ProductReviewDataSource)

Ürün yorumu veri kaynağı.
merchantReviewDataSource

object (MerchantReviewDataSource)

Satıcı yorumu veri kaynağı.

PrimaryProductDataSource

Yerel ve online ürünler için birincil veri kaynağı.

JSON gösterimi 
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "defaultRule": {
    object (DefaultRule)
  },
  "feedLabel": string,
  "contentLanguage": string
}
Alanlar
channel

enum (Channel)

Zorunlu. Değişmez. Veri kaynağı kanalının türünü belirtir.
countries[]

string

İsteğe bağlıdır. Öğelerin gösterilebileceği ülkeler. CLDR bölge kodu olarak temsil edilir.
defaultRule

object (DefaultRule)

İsteğe bağlıdır. Veri kaynağının varsayılan kural yönetimi. Bu ayar etkinleştirilirse bağlı veri kaynakları değiştirilir.
feedLabel

string

İsteğe bağlıdır. Değişmez. Veri kaynağı düzeyinde belirtilen feed etiketi.

Büyük harf (A-Z), rakam (0-9) ve kısa çizgi (-) karakterlerinden oluşmalı ve 20 karakterden kısa olmalıdır.

Feed etiketlerine taşıma başlıklı makaleyi de inceleyin.

Ürün içeriği türüne sahip veri kaynakları için feedLabel ve contentLanguage parametreleri ya ayarlanmalı ya da ayarlanmamış olmalıdır. Dosya girişi olan veri kaynakları için ayarlanmalıdır.

Ayarlanırsa veri kaynağı yalnızca bu kombinasyonla eşleşen ürünleri kabul eder. Ayarlanmazsa veri kaynağı, ürünleri bu kısıtlama olmadan kabul eder.
contentLanguage

string

İsteğe bağlıdır. Değişmez. Veri kaynağındaki öğelerin iki harfli ISO 639-1 dili.

feedLabel ve contentLanguage, ikisi birden ayarlanmış veya ikisi birden ayarlanmamış olmalıdır. Alanlar yalnızca dosya girişi olmayan veri kaynakları için ayarlanabilir.

Ayarlanırsa veri kaynağı yalnızca bu kombinasyonla eşleşen ürünleri kabul eder. Ayarlanmazsa veri kaynağı, ürünleri bu kısıtlama olmadan kabul eder.

Kanal

Veri Kaynağı Kanalı.

Kanal, farklı ürün sektörlerine ait veri kaynaklarını ayırt etmek için kullanılır.

Sıralamalar
CHANNEL_UNSPECIFIED Belirtilmedi.
ONLINE_PRODUCTS Online ürün.
LOCAL_PRODUCTS Yerel ürün.
PRODUCTS Hem yerel hem de online ürünler için birleştirilmiş veri kaynağı. Not: Bu kanalda API üzerinden ürün yönetimi yapılamaz.

DefaultRule

Veri kaynağının varsayılan kural yönetimi.

JSON gösterimi 
{
  "takeFromDataSources": [
    {
      object (DataSourceReference)
    }
  ]
}
Alanlar
takeFromDataSources[]

object (DataSourceReference)

Zorunlu. Varsayılan kurala bağlı veri kaynaklarının listesi. Bu liste, verileri birleştirme işleminin varsayılan kural önceliğine göre sıralanır. self ve ek veri kaynaklarına hiç referans içermeyebilir veya birden fazla referans içerebilir.

Liste boş olmamalıdır.

Veri kaynağını varsayılan kurala bağlamak için bu listeye yeni bir referans eklemeniz gerekir (sıralı düzende).

Veri kaynağının varsayılan kuralla bağlantısını kaldırmak için verilen referansı bu listeden kaldırmanız gerekir.

Bu listenin sırası değiştirildiğinde varsayılan kuraldaki veri kaynaklarının önceliği de değişir.

Örneğin, şu listeyi gönderirseniz: [1001, self] özellik değerleri 1001 ek veri kaynağından alınır ve özellik 1001'te ayarlanmamışsa self'a geri döner.

DataSourceReference

Veri kaynağı referansı, veri kaynağı hizmetindeki ilgili veri kaynaklarını yönetmek için kullanılabilir.

JSON gösterimi 
{

  // 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.
}
Alanlar

Birlik alanı data_source_id.

data_source_id yalnızca aşağıdakilerden biri olabilir:
self

boolean

Birincil veri kaynağına referans vermek için self kullanılmalıdır.
primaryDataSourceName

string

İsteğe bağlıdır. Birincil veri kaynağının adı. Biçim: accounts/{account}/dataSources/{datasource}
supplementalDataSourceName

string

İsteğe bağlıdır. Ek veri kaynağının adı. Biçim: accounts/{account}/dataSources/{datasource}

SupplementalProductDataSource

Yerel ve online ürünler için ek veri kaynağı. Oluşturduktan sonra ek ürün veri kaynağını bir veya daha fazla birincil ürün veri kaynağına bağladığınızdan emin olun.

JSON gösterimi 
{
  "referencingPrimaryDataSources": [
    {
      object (DataSourceReference)
    }
  ],
  "feedLabel": string,
  "contentLanguage": string
}
Alanlar
referencingPrimaryDataSources[]

object (DataSourceReference)

Yalnızca çıkış. Varsayılan veya özel kurallarda bu veri kaynağına bağlı tüm birincil veri kaynaklarının listesi (sıralı olmayan ve tekilleştirilmemiş). Tüm bağlantılar kaldırılmadan ek veri kaynağı silinemez.
feedLabel

string

İsteğe bağlıdır. Değişmez. Veri kaynağı düzeyinde belirtilen feed etiketi.

Büyük harf (A-Z), rakam (0-9) ve kısa çizgi (-) karakterlerinden oluşmalı ve 20 karakterden kısa olmalıdır.

Feed etiketlerine taşıma başlıklı makaleyi de inceleyin.

Ürün içeriği türüne sahip veri kaynakları için feedLabel ve contentLanguage parametreleri ya ayarlanmalı ya da ayarlanmamış olmalıdır.

Bunlar, file input içeren veri kaynakları için ayarlanmalıdır. file input içermeyen veri kaynakları için alanların değeri kaldırılmalıdır.

Ayarlanırsa veri kaynağı yalnızca bu kombinasyonla eşleşen ürünleri kabul eder. Ayarlanmamışsa veri kaynağı, ürünleri bu kısıtlama olmadan kabul eder.
contentLanguage

string

İsteğe bağlıdır. Değişmez. Veri kaynağındaki öğelerin iki harfli ISO 639-1 dili.

feedLabel ve contentLanguage, ikisi birden ayarlanmış veya ikisi birden ayarlanmamış olmalıdır. Alanlar yalnızca dosya girişi olmayan veri kaynakları için ayarlanabilir.

Ayarlanırsa veri kaynağı yalnızca bu kombinasyonla eşleşen ürünleri kabul eder. Ayarlanmamışsa veri kaynağı, ürünleri bu kısıtlama olmadan kabul eder.

LocalInventoryDataSource

Yerel envanter veri kaynağı.

JSON gösterimi 
{
  "feedLabel": string,
  "contentLanguage": string
}
Alanlar
feedLabel

string

Zorunlu. Değişmez. Yerel envanterin sağlandığı tekliflerin feed etiketi.

Büyük harf (A-Z), rakam (0-9) ve kısa çizgi (-) karakterlerinden oluşmalı ve 20 karakterden kısa olmalıdır.

Feed etiketlerine taşıma başlıklı makaleyi de inceleyin.
contentLanguage

string

Zorunlu. Değişmez. Yerel envanterin sağlandığı öğelerin iki harfli ISO 639-1 dili.

RegionalInventoryDataSource

Bölgesel envanter veri kaynağı.

JSON gösterimi 
{
  "feedLabel": string,
  "contentLanguage": string
}
Alanlar
feedLabel

string

Zorunlu. Değişmez. Bölgesel envanterin sağlandığı tekliflerin feed etiketi.

Büyük harf (A-Z), rakam (0-9) ve kısa çizgi (-) karakterlerinden oluşmalı ve 20 karakterden kısa olmalıdır.

Feed etiketlerine taşıma başlıklı makaleyi de inceleyin.
contentLanguage

string

Zorunlu. Değişmez. Bölgesel envanterin sağlandığı öğelerin iki harfli ISO 639-1 dili.

PromotionDataSource

Promosyon veri kaynağı.

JSON gösterimi 
{
  "targetCountry": string,
  "contentLanguage": string
}
Alanlar
targetCountry

string

Zorunlu. Değişmez. Benzersiz tanımlayıcının bir parçası olarak kullanılan hedef ülke. CLDR bölge kodu olarak temsil edilir.

Promosyonlar yalnızca belirli ülkelerde kullanılabilir.
contentLanguage

string

Zorunlu. Değişmez. Veri kaynağındaki öğelerin iki harfli ISO 639-1 dili.

ProductReviewDataSource

Bu türde alan yoktur.

Ürün yorumu veri kaynağı.

MerchantReviewDataSource

Bu türde alan yoktur.

Satıcı yorumu veri kaynağı.

Giriş

Veri kaynağına girilen giriş türünü belirler. Girdiğiniz bilgilere bağlı olarak bazı ayarlar desteklenmeyebilir.

Sıralamalar
INPUT_UNSPECIFIED Giriş belirtilmedi.
API Verilerin öncelikle API üzerinden sağlandığı veri kaynaklarını temsil eder.
FILE Verilerin öncelikle dosya girişi aracılığıyla sağlandığı veri kaynaklarını temsil eder. Veriler API üzerinden yine de sağlanabilir.
UI

Doğrudan Merchant Center'a eklenen ürünlerin veri kaynağı.

Bu tür veri kaynakları bu API aracılığıyla oluşturulamaz veya güncellenemez. Yalnızca Merchant Center kullanıcı arayüzü üzerinden oluşturulabilir veya güncellenebilir.

Bu veri kaynağı türü salt okunurdur.
AUTOFEED Bu işlem, ürün verilerinizi otomatik olarak oluşturmak için kullanılan otomatik feed'ler olarak da bilinir. Bu tür veri kaynakları, Hesaplar paketi aracılığıyla etkinleştirilebilir veya devre dışı bırakılabilir.

FileInput

Dosya veri kaynaklarına özgü veriler. Bu alan, diğer veri kaynağı girişleri için boştur.

JSON gösterimi 
{
  "fetchSettings": {
    object (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
Alanlar
fetchSettings

object (FetchSettings)

İsteğe bağlıdır. Veri kaynağını yayınlamak için ayrıntıları getirin. FETCH ve GOOGLE_SHEETS dosya giriş türleriyle ilgili ayarları içerir. Zorunlu alanlar, getirme sıklığına göre değişiklik gösterir.
fileName

string

İsteğe bağlıdır. Veri kaynağının dosya adı. UPLOAD dosya giriş türü için gereklidir.
fileInputType

enum (FileInputType)

Yalnızca çıkış. Dosya girişinin türü.

FetchSettings

Veri kaynağını yayınlamak için ayrıntıları getirin.

JSON gösterimi 
{
  "enabled": boolean,
  "dayOfMonth": integer,
  "timeOfDay": {
    object (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
Alanlar
enabled

boolean

İsteğe bağlıdır. Getirme planını etkinleştirir veya duraklatır.
dayOfMonth

integer

İsteğe bağlıdır. Veri kaynağı dosyasının getirileceği ayın günü (1-31). Bu alan yalnızca aylık sıklık için ayarlanabilir.
timeOfDay

object (TimeOfDay)

İsteğe bağlıdır. Veri kaynağı dosyasının getirileceği günün saati. Dakika ve saniyeler desteklenmez ve yoksayılır.
dayOfWeek

enum (DayOfWeek)

İsteğe bağlıdır. Veri kaynağı dosyasının getirileceği haftanın günü. Bu alan yalnızca haftalık sıklık için ayarlanabilir.
timeZone

string

İsteğe bağlıdır. Program için kullanılan saat dilimi. Varsayılan olarak UTC. Örneğin, "Amerika/Los_Angeles".
frequency

enum (Frequency)

Zorunlu. Getirme planını açıklayan sıklık.
fetchUri

string

İsteğe bağlıdır. Veri kaynağı dosyasının alınabileceği URL. Google Merchant Center, HTTP, HTTPS veya SFTP protokollerini kullanarak otomatik olarak planlanmış yüklemeleri destekler. Bu nedenle, değerin bu üç protokolden birini kullanan geçerli bir bağlantı olması gerekir. Google E-Tablolar dosyaları için sabit.
username

string

İsteğe bağlıdır. fetchUri için isteğe bağlı bir kullanıcı adı. Veri kaynaklarını SFTP üzerinden göndermek için kullanılır.
password

string

İsteğe bağlıdır. fetchUri için isteğe bağlı bir şifre. Veri kaynaklarını SFTP üzerinden göndermek için kullanılır.

TimeOfDay

Günün bir saatini temsil eder. Tarih ve saat dilimi önemli değil veya başka bir yerde belirtilmiş. Bir API, saniye atlamalarına izin vermeyi seçebilir. İlgili türler google.type.Date ve google.protobuf.Timestamp'dur.

JSON gösterimi 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Alanlar
hours

integer

Bir günün 24 saatlik biçimindeki saatleri. 0'dan büyük veya 0'a eşit ve genellikle 23'ten küçük veya 23'e eşit olmalıdır. Bir API, işletmenin kapanma zamanı gibi senaryolar için "24:00:00" değerine izin vermeyi seçebilir.
minutes

integer

Bir saatin dakikaları. 0'dan büyük veya 0'a eşit ve 59'dan küçük olmalıdır.
seconds

integer

Bir dakikanın saniyeleri. 0'dan büyük veya 0'a eşit ve genellikle 59'dan küçük veya 59'a eşit olmalıdır. Bir API, saniye atlamalarına izin veriyorsa 60 değerine izin verebilir.
nanos

integer

Nanosaniye cinsinden saniye kesirlerini belirtir. 0'dan büyük veya 0'a eşit ve 999.999.999'dan küçük veya buna eşit olmalıdır.

HaftanınGünü

Haftanın bir gününü temsil eder.

Sıralamalar
DAY_OF_WEEK_UNSPECIFIED Haftanın günü belirtilmemiş.
MONDAY Pazartesi
TUESDAY Salı
WEDNESDAY Çarşamba
THURSDAY Perşembe
FRIDAY Cuma
SATURDAY Cumartesi
SUNDAY Pazar

Sıklık

Zorunlu alanlar, getirme sıklığına göre değişiklik gösterir. Aylık getirme planı için [ayın günü][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] ve [saat][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] gereklidir. Haftalık getirme planı için [haftanın günü][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] ve [saat][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] değerleri gereklidir. Günlük getirme planı için yalnızca [saat][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] gereklidir.

Sıralamalar
FREQUENCY_UNSPECIFIED Sıklık belirtilmemiş.
FREQUENCY_DAILY Getirme işlemi her gün gerçekleşir.
FREQUENCY_WEEKLY Getirme işlemi her hafta gerçekleşir.
FREQUENCY_MONTHLY Getirme işlemi her ay gerçekleşir.

FileInputType

Dosya yayınlama yöntemi.

Sıralamalar
FILE_INPUT_TYPE_UNSPECIFIED Dosya giriş türü belirtilmedi.
UPLOAD Dosya, SFTP, Google Cloud Storage veya Merchant Center'da manuel olarak yüklenir.
FETCH Dosya, yapılandırılan fetchUri'ten alınır.
GOOGLE_SHEETS Dosya, fetchUri içinde belirtilen Google E-Tablolar'dan alınır.

Yöntemler

create

 Belirtilen hesap için yeni veri kaynağı yapılandırmasını oluşturur.

delete

 Merchant Center hesabınızdaki bir veri kaynağını siler.

fetch

 Merchant Center hesabınızdaki bir veri kaynağında veri getirme işlemini hemen (getirme planı dışında bile) gerçekleştirir.

get

 Belirtilen hesabın veri kaynağı yapılandırmasını alır.

list

 Belirtilen hesaptaki veri kaynaklarının yapılandırmalarını listeler.

patch

 Mevcut veri kaynağı yapılandırmasını günceller.