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 sayfasına bakın.
DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

Merchant Center hesabınızdaki bir veri kaynağını 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 sayfasına bakın.
FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

Merchant Center hesabınızdaki bir veri kaynağında veri getirme işlemini hemen (getirme planı dışında bile) gerçekleştirir. Bu yöntemi günde bir kereden fazla çağırmanız gerekiyorsa ürün verilerinizi güncellemek için Ürünler hizmetini kullanmanız gerekir. Bu yöntem yalnızca dosya girişi ayarlanmış veri kaynaklarında ç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 sayfasına bakın.
GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

Belirtilen 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 sayfasına bakın.
ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

Belirtilen hesaptaki 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 sayfasına bakı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 sayfasına bakın.

FileUploadsService

Veri kaynağı dosya yüklemelerini yönetmek için kullanılan hizmet.

GetFileUpload

rpc GetFileUpload(GetFileUploadRequest) returns (FileUpload)

En son veri kaynağı dosyası yüklemesini alır. Dosya yükleme için yalnızca latest takma adı kabul edilir.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakı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 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.
file_input

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

PrimaryProductDataSource

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

SupplementalProductDataSource

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

LocalInventoryDataSource

Yerel envanter veri kaynağı.
regional_inventory_data_source

RegionalInventoryDataSource

Bölgesel envanter veri kaynağı.
promotion_data_source

PromotionDataSource

Promosyon veri kaynağı.
product_review_data_source

ProductReviewDataSource

Ürün yorumu veri kaynağı.
merchant_review_data_source

MerchantReviewDataSource

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 aracılığıyla 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 tür veri kaynakları 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.

DataSourceReference

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

Alanlar

Birlik alanı data_source_id.

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

bool

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

string

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

string

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

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 özgü veriler. Bu alan, diğer veri kaynağı girişleri için boştur.

Alanlar
fetch_settings

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

string

İsteğe bağlıdır. Veri kaynağının dosya adı. UPLOAD dosya giriş türü için gereklidir.
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ıdır. Getirme planını etkinleştirir veya duraklatır.
day_of_month

int32

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

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

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

string

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

Frequency

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

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 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 sabit.
username

string

İsteğe bağlıdır. fetch_uri 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. fetch_uri için isteğe bağlı bir şifre. Veri kaynaklarını SFTP üzerinden göndermek için kullanılır.

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 fetch_uri'ten alınır.
GOOGLE_SHEETS Dosya, fetch_uri içinde belirtilen Google E-Tablolar'dan alınır.

FileUpload

Belirli bir veri kaynağının dosya yüklemesi, yani veri kaynağı işleme işlemi tamamlandığında eşzamansız olarak hesaplanan belirli bir zaman damgasında veri kaynağının alınmasının sonucu. Yalnızca dosya veri kaynakları için geçerlidir.

Alanlar
name

string

Tanımlayıcı. Veri kaynağı dosyası yüklemesinin adı. Biçim: {datasource.name=accounts/{account}/dataSources/{datasource}/fileUploads/{fileupload}}
data_source_id

int64

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

ProcessingState

Yalnızca çıkış. Veri kaynağının işleme durumu.
issues[]

Issue

Yalnızca çıkış. Veri kaynağında oluşan sorunların listesi.
items_total

int64

Yalnızca çıkış. Veri kaynağındaki işlenmiş öğelerin sayısı.
items_created

int64

Yalnızca çıkış. Veri kaynağında oluşturulan öğelerin sayısı.
items_updated

int64

Yalnızca çıkış. Veri kaynağındaki güncellenen öğelerin sayısı.
upload_time

Timestamp

Yalnızca çıkış. Veri kaynağının dosyasının yüklendiği tarih.

Sorun

Veri kaynağında "geçersiz fiyat" gibi bir hata oluştu.

Alanlar
title

string

Yalnızca çıkış. Sorunun başlığı (ör. "Öğe çok büyük").
description

string

Yalnızca çıkış. Hata açıklaması (ör. "Veri kaynağınız çok fazla özelliğe sahip veya çok büyük öğeler içeriyor. Bu öğeler kaldırılacak".
code

string

Yalnızca çıkış. Hatanın kodu (ör. "validation/invalid_value"). Kod bilinmiyorsa "?" döndürür.
count

int64

Yalnızca çıkış. Dosya yükleme sırasında hatanın kaç kez oluştuğu.
severity

Severity

Yalnızca çıkış. Sorunun önem derecesi.
documentation_uri

string

Yalnızca çıkış. Varsa sorunu daha ayrıntılı şekilde açıklayan dokümanların bağlantısı.

Önem derecesi

Sorunun önem derecesi.

Sıralamalar
SEVERITY_UNSPECIFIED Önem düzeyi belirtilmemiş.
WARNING Sorun, uyarıdır.
ERROR Sorun bir hatadır.

ProcessingState

Veri kaynağının işleme durumu.

Sıralamalar
PROCESSING_STATE_UNSPECIFIED İşleme durumu belirtilmemiş.
FAILED Veri kaynağı işlenemedi veya tüm öğelerde hata vardı.
IN_PROGRESS Veri kaynağı işleniyor.
SUCCEEDED Veri kaynağı başarıyla işlendi ancak bazı öğelerde hata olabilir.

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}

GetFileUploadRequest

GetFileUploadRequest yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Alınacak veri kaynağı dosyası yüklemesinin adı. Biçim: accounts/{account}/dataSources/{datasource}/fileUploads/latest

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ır. Döndürülecek maksimum veri kaynağı sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Maksimum değer 1.000'dür. 1.000'den yüksek değerler 1.000'e zorlanacaktır. Belirtilmemesi durumunda maksimum veri kaynağı sayısı döndürülür.
page_token

string

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

Sayfalandırma yaparken ListDataSources parametresine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListDataSourcesResponse

ListDataSources yöntemi için yanıt mesajı.

Alanlar
data_sources[]

DataSource

Belirtilen hesaptaki veri kaynakları.
next_page_token

string

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

LocalInventoryDataSource

Yerel envanter veri kaynağı.

Alanlar
feed_label

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

string

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

MerchantReviewDataSource

Bu türde alan yoktur.

Satıcı yorumu veri kaynağı.

PrimaryProductDataSource

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

Alanlar
channel

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

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

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

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.

Alanlar
take_from_data_sources[]

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.

ProductReviewDataSource

Bu türde alan yoktur.

Ürün yorumu veri kaynağı.

PromotionDataSource

Promosyon veri kaynağı.

Alanlar
target_country

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

string

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

RegionalInventoryDataSource

Bölgesel envanter veri kaynağı.

Alanlar
feed_label

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

string

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

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.

Alanlar
referencing_primary_data_sources[]

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ştirilmiş). Tüm bağlantılar kaldırılmadan ek veri kaynağı silinemez.
feed_label

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 ayarlanmamış olmalı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.
content_language

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.

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üncelleme maskesinde belirtilen ancak gövdede değeri belirtilmeyen alanlar veri kaynağından silinir.

Tam veri kaynağı değişimi için özel "*" değeri sağlama desteklenmez.