Package google.shopping.merchant.datasources.v1beta

Dizin

DataSourcesService

Birincil, ek envanter ve diğer veri kaynaklarını yönetme hizmeti. Daha fazla bilgi için Merchant Center yardım makalesini inceleyin.

CreateDataSource

rpc CreateDataSource(CreateDataSourceRequest) returns (DataSource)

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

Veri getirme işlemini Merchant Center hesabınızdaki bir veri kaynağında hemen (getirme planının dışında bile) gerçekleştirir. Bu yöntemi günde bir defadan fazla çağırmanız gerekiyorsa bunun yerine ürün verilerinizi güncellemek için Ürünler hizmetini kullanmanız gerekir. Bu yöntem yalnızca bir dosya girişi ayarlanmış veri kaynaklarında kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

UpdateDataSource

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

Mevcut veri kaynağı yapılandırmasını günceller. Güncelleme maskesinde ayarlanan ancak kaynakta sağlanmayan alanlar silinir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

CreateDataSourceRequest

CreateDataSource yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Bu veri kaynağının oluşturulacağı hesap. Biçim: accounts/{account}

data_source

DataSource

Zorunlu. Oluşturulacak veri kaynağı.

DataSource

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

Alanlar
name

string

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

data_source_id

int64

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

display_name

string

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

input

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.

file_input

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:
primary_product_data_source

PrimaryProductDataSource

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

supplemental_product_data_source

SupplementalProductDataSource

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

local_inventory_data_source

LocalInventoryDataSource

Zorunlu. Yerel envanter veri kaynağı.

regional_inventory_data_source

RegionalInventoryDataSource

Zorunlu. Bölgesel envanter veri kaynağı.

promotion_data_source

PromotionDataSource

Zorunlu. Promosyon veri kaynağı.

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.

DeleteDataSourceRequest

DeleteDataSource yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Silinecek veri kaynağının adı. Biçim: accounts/{account}/dataSources/{datasource}

FetchDataSourceRequest

FetchDataSource yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Getirilecek veri kaynağı kaynağının adı. Biçim: accounts/{account}/dataSources/{datasource}

FileInput

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

Alanlar
fetch_settings

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.

file_name

string

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

file_input_type

FileInputType

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

FetchSettings

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

Alanlar
enabled

bool

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

day_of_month

int32

İ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.

time_of_day

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.

day_of_week

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.

time_zone

string

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

frequency

Frequency

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

fetch_uri

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.

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ılmış [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] konumundan getirilir.
GOOGLE_SHEETS Dosya, [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] içinde belirtilen Google E-Tablolar'dan getirilir.

GetDataSourceRequest

GetDataSource yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Alınacak veri kaynağının adı. Biçim: accounts/{account}/dataSources/{datasource}

ListDataSourcesRequest

ListDataSources yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Veri kaynaklarının listeleneceği hesap. Biçim: accounts/{account}

page_size

int32

İsteğe bağlı. Döndürülecek maksimum veri kaynağı sayısı. Hizmet bu değerden daha az bir değer döndürebilir. Maksimum değer 1000'dir; 1.000'in üzerindeki değerler 1.000'e zorlanır. Belirtilmemişse maksimum sayıda veri kaynağı döndürülür.

page_token

string

İsteğe bağlı. Önceki ListDataSources çağrısından alınan bir sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi sırasında ListDataSources öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListDataSourcesResponse

ListDataSources yönteminin yanıt iletisi.

Alanlar
data_sources[]

DataSource

Belirtilen hesaptaki veri kaynakları.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilecek bir jeton. Bu alan atlanırsa sonraki sayfa olmaz.

LocalInventoryDataSource

Yerel envanter veri kaynağı.

Alanlar
feed_label

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.

content_language

string

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

PrimaryProductDataSource

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

Alanlar
channel

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.

feed_label

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.

content_language

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.

PromotionDataSource

Promosyon veri kaynağı.

Alanlar
target_country

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.

content_language

string

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

RegionalInventoryDataSource

Bölgesel envanter veri kaynağı.

Alanlar
feed_label

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.

content_language

string

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

SupplementalProductDataSource

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

Alanlar
feed_label

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.

content_language

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.

UpdateDataSourceRequest

UpdateDataSource yöntemi için istek mesajı.

Alanlar
data_source

DataSource

Zorunlu. Güncellenecek veri kaynağı kaynağı.

update_mask

FieldMask

Zorunlu. Güncellenecek veri kaynağı alanlarının listesi.

Gövdede bir değer belirtilmemişse güncelleme maskesinde belirtilen alanlar veri kaynağından silinir.

Özel "*" sağlayarak tam veri kaynağı değişimi değeri desteklenmiyor.