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'a Genel Bakış başlıklı makaleyi inceleyin.
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'a Genel Bakış başlıklı makaleyi inceleyin.
FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

Merchant Center hesabınızdaki bir veri kaynağında veri getirme işlemini hemen (getirme planı dışındayken 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'a Genel Bakış başlıklı makaleyi inceleyin.
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'a Genel Bakış başlıklı makaleyi inceleyin.
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'a Genel Bakış başlıklı makaleyi inceleyin.
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'a Genel Bakış başlıklı makaleyi inceleyin.

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'a Genel Bakış başlıklı makaleyi inceleyin.

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ı. Alan yalnızca veriler bir dosya üzerinden yönetildiğinde kullanılır.
Birlik alanı Type. Veri kaynağı türü. Type yalnızca aşağıdakilerden biri olabilir:
primary_product_data_source

PrimaryProductDataSource

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

SupplementalProductDataSource

Zorunlu. Yerel ve online ü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ğı.
product_review_data_source

ProductReviewDataSource

Zorunlu. Ürün yorumu veri kaynağı.
merchant_review_data_source

MerchantReviewDataSource

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

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ı. Birincil veri kaynağının adı. Biçim: accounts/{account}/dataSources/{datasource}
supplemental_data_source_name

string

İsteğe bağlı. 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ı. 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ı. 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ı. Getirme planını etkinleştirir veya duraklatır.
day_of_month

int32

İsteğe bağlı. 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ı. 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ı. 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ı. 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ı. 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ı. 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ı. 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] parametreleri 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 belirtilmedi.
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şlenen öğ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ö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 büyük 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ı. Ö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 sayfalar 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ı. Öğelerin gösterilebileceği ülkeler. CLDR bölge kodu olarak temsil edilir.
default_rule

DefaultRule

İsteğe bağlı. Veri kaynağının varsayılan kural yönetimi. Bu ayar etkinse bağlı veri kaynakları değiştirilir.
feed_label

string

İsteğe bağlı. 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 değerlerinin ikisi de ayarlanmalı veya ikisi de 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ı. Değişmez. Veri kaynağındaki öğelerin iki harfli ISO 639-1 dili.

feedLabel ve contentLanguage alanlarının ikisi birden ayarlanmalı ya da 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 verisi kaynağını bir veya daha fazla birincil ürün verisi 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ştirilmemiş). Tüm bağlantılar kaldırılmadan ek veri kaynağı silinemez.
feed_label

string

İsteğe bağlı. 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 değerlerinin ikisi de ayarlanmalı veya ikisi de 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.
content_language

string

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

feedLabel ve contentLanguage alanlarının ikisi birden ayarlanmalı ya da 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.