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)
  }
  // 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 yapılan girişin türünü belirler. Girişe bağlı olarak bazı ayarlar çalışmayabilir. API aracılığıyla yalnızca genel veri kaynakları oluşturulabilir.

fileInput

object (FileInput)

İsteğe bağlı. Bu alan yalnızca veriler bir dosya üzerinden yönetildiğinde kullanılır.

Birleştirme alanı Type. Veri kaynağı türü. Type şunlardan yalnızca biri olabilir:
primaryProductDataSource

object (PrimaryProductDataSource)

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

supplementalProductDataSource

object (SupplementalProductDataSource)

Zorunlu. Yerel ve çevrimiçi ürünler için ek veri kaynağı.

localInventoryDataSource

object (LocalInventoryDataSource)

Zorunlu. Yerel envanter veri kaynağı.

regionalInventoryDataSource

object (RegionalInventoryDataSource)

Zorunlu. Bölgesel envanter veri kaynağı.

promotionDataSource

object (PromotionDataSource)

Zorunlu. Promosyon veri kaynağı.

PrimaryProductDataSource

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

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

enum (Channel)

Zorunlu. Sabit. Veri kaynağı kanalının türünü belirtir.

countries[]

string

İsteğe bağlı. Öğelerin gösterilebileceği ülkeler. CLDR bölge kodu olarak gösterilir.

feedLabel

string

İsteğe bağlı. Sabit. Veri kaynağı düzeyinde belirtilen feed etiketi.

En fazla 20 büyük harf (A-Z), rakam (0-9) ve kısa çizgi (-) içermelidir.

Ayrıca feed etiketlerine taşıma konusuna bakın.

Ürün içeriği türüne sahip veri kaynakları için feedLabel ve contentLanguage ayarlanmalı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. Politika ayarlanmadan bırakılırsa veri kaynağı, bu kısıtlamanın olmadığı ürünleri kabul eder.

contentLanguage

string

İsteğe bağlı. Sabit. Veri kaynağındaki öğelerin iki harfli ISO 639-1 dilidir.

feedLabel ve contentLanguage her ikisi de ayarlanmalı veya ayarlanmamış olmalıdır. Alanlar, yalnızca dosya girişi olmayan veri kaynakları için kaldırılabilir.

Ayarlanırsa veri kaynağı yalnızca bu kombinasyonla eşleşen ürünleri kabul eder. Politika ayarlanmadan bırakılırsa veri kaynağı, bu kısıtlamanın olmadığı ürünleri kabul eder.

Kanal

Veri Kaynağı Kanalı.

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

Sıralamalar
CHANNEL_UNSPECIFIED Belirtilmedi.
ONLINE_PRODUCTS Çevrimiçi ü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 aracılığıyla ürün yönetimi yapılamaz.

SupplementalProductDataSource

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

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

string

İsteğe bağlı. Sabit. Veri kaynağı düzeyinde belirtilen feed etiketi.

En fazla 20 büyük harf (A-Z), rakam (0-9) ve kısa çizgi (-) içermelidir.

Ayrıca feed etiketlerine taşıma konusuna bakın.

Ürün içeriği türüne sahip veri kaynakları için feedLabel ve contentLanguage ayarlanmalı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. Politika ayarlanmadan bırakılırsa veri kaynağı, bu kısıtlama olmadan ürünleri kabul eder.

contentLanguage

string

İsteğe bağlı. Sabit. Veri kaynağındaki öğelerin iki harfli ISO 639-1 dilidir.

feedLabel ve contentLanguage her ikisi de ayarlanmalı veya ayarlanmamış olmalıdır. Alanlar, yalnızca dosya girişi olmayan veri kaynakları için kaldırılabilir.

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

LocalInventoryDataSource

Yerel envanter veri kaynağı.

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

string

Zorunlu. Sabit. Yerel envanterin sağlandığı tekliflerin feed etiketi.

En fazla 20 büyük harf (A-Z), rakam (0-9) ve kısa çizgi (-) içermelidir.

Ayrıca feed etiketlerine taşıma konusuna bakın.

contentLanguage

string

Zorunlu. Sabit. Yerel envanterin sağlandığı öğelerin iki harfli ISO 639-1 dilidir.

RegionalInventoryDataSource

Bölgesel envanter veri kaynağı.

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

string

Zorunlu. Sabit. Bölgesel envanterin sağlandığı tekliflerin feed etiketi.

En fazla 20 büyük harf (A-Z), rakam (0-9) ve kısa çizgi (-) içermelidir.

Ayrıca feed etiketlerine taşıma konusuna bakın.

contentLanguage

string

Zorunlu. Sabit. Bölgesel envanterin sağlandığı öğelerin iki harfli ISO 639-1 dilidir.

PromotionDataSource

Promosyon veri kaynağı.

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

string

Zorunlu. Sabit. Benzersiz tanımlayıcının parçası olarak kullanılan hedef ülke. CLDR bölge kodu olarak gösterilir.

Promosyonlar yalnızca belirli ülkelerde kullanılabilir.

contentLanguage

string

Zorunlu. Sabit. Veri kaynağındaki öğelerin iki harfli ISO 639-1 dilidir.

Giriş

Veri kaynağına yapılan girişin türünü belirler. Girişe bağlı olarak bazı ayarlar desteklenmeyebilir.

Sıralamalar
INPUT_UNSPECIFIED Giriş belirtilmedi.
API Verilerin temel olarak API üzerinden sağlandığı veri kaynaklarını temsil eder.
FILE Verilerin temel olarak dosya girişi üzerinden sağlandığı veri kaynaklarını temsil eder. Veriler, API aracılığıyla sağlanmaya devam edebilir.
UI

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

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

Bu veri kaynağı türü salt okunurdur.

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

FileInput

Dosya veri kaynaklarına özel 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ı. 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 bağlı olarak değişiklik gösterir.

fileName

string

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

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ı. Getirme planını etkinleştirir veya duraklatır.

dayOfMonth

integer

İsteğe bağlı. Veri kaynağı dosyasının alınması gereken 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ı. Veri kaynağı dosyasının günün hangi saatinde getirileceği. Dakika ve saniye desteklenmediği için yoksayılacak.

dayOfWeek

enum (DayOfWeek)

İsteğe bağlı. Veri kaynağı dosyasının alınması gereken gün. Bu alan yalnızca haftalık sıklık için ayarlanabilir.

timeZone

string

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

frequency

enum (Frequency)

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

fetchUri

string

İsteğe bağlı. Veri kaynağı dosyasının getirilebileceği URL. Google Merchant Center; HTTP, HTTPS veya SFTP protokolleri kullanılarak yapılan otomatik planlı yüklemeleri destekler. Bu nedenle, değerin bu üç protokolden birini kullanan geçerli bir bağlantı olması gerekir. Google E-Tablolar dosyaları için sabittir.

username

string

İsteğe bağlı. [getirme url][google.shopping.content.bundles.DataSources.FileInput.fetch_url] için isteğe bağlı kullanıcı adı. SFTP üzerinden veri kaynaklarını göndermek için kullanılır.

password

string

İsteğe bağlı. [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url] için isteğe bağlı şifre. SFTP üzerinden veri kaynaklarını göndermek için kullanılır.

TimeOfDay

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

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

integer

24 saat biçiminde günün saatleri. 0 ile 23 arasında olmalıdır. Bir API, "24:00:00" değerine izin vermeyi seçebilir. gibi senaryolar için oldukça yararlı olabilir.

minutes

integer

Günün saatindeki dakikalar. 0 ile 59 arasında olmalıdır.

seconds

integer

Saniye cinsinden dakika. Normalde 0 ile 59 arasında olmalıdır. Bir API, artık saniyeye izin veriyorsa 60 değerine izin verebilir.

nanos

integer

Nanosaniye cinsinden saniyenin kesirleri. 0 ile 999.999.999 arasında 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 bağlı olarak 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 [saatin saati][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 [günün saati][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] gereklidir. Günlük getirme planı için yalnızca [günün saati][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] gereklidir.

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

FileInputType

Dosya yayınlama yöntemi.

Sıralamalar
FILE_INPUT_TYPE_UNSPECIFIED Dosya giriş türü belirtilmedi.
UPLOAD Dosya; SFTP veya Google Cloud Storage aracılığıyla ya da Merchant Center'a manuel olarak yüklenir.
FETCH Dosya, yapılandırılan [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] kaynağından getirilir.
GOOGLE_SHEETS Dosya, [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] içinde belirtilen Google E-Tablolar'dan getirilir.

Yöntemler

create

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

delete

Bir veri kaynağını Merchant Center hesabınızdan siler.

fetch

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

get

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

list

Belirli bir hesaba ait veri kaynaklarının yapılandırmalarını listeler.

patch

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