Package google.shopping.merchant.datasources.v1beta

Indeks

DataSourcesService

Layanan untuk mengelola inventaris utama, tambahan, inventaris, dan sumber data lainnya. Lihat selengkapnya di artikel bantuan Merchant Center.

CreateDataSource

rpc CreateDataSource(CreateDataSourceRequest) returns (DataSource)

Membuat konfigurasi sumber data baru untuk akun tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

Menghapus sumber data dari akun Merchant Center Anda.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

Melakukan pengambilan data secara langsung (bahkan di luar jadwal pengambilan) pada sumber data dari Akun Merchant Center Anda. Jika Anda perlu memanggil metode ini lebih dari sekali per hari, Anda harus menggunakan layanan Produk untuk memperbarui data produk. Metode ini hanya berfungsi pada sumber data dengan kumpulan input file.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

Mengambil konfigurasi sumber data untuk akun tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

Mencantumkan konfigurasi untuk sumber data untuk akun tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
UpdateDataSource

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

Memperbarui konfigurasi sumber data yang ada. Kolom yang ditetapkan dalam mask update tetapi tidak disediakan dalam resource akan dihapus.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

CreateDataSourceRequest

Pesan permintaan untuk metode CreateDataSource.

Kolom
parent

string

Wajib. Akun tempat sumber data ini akan dibuat. Format: accounts/{account}
data_source

DataSource

Wajib. Sumber data yang akan dibuat.

DataSource

Sumber data untuk akun Merchant Center.

Kolom
name

string

ID. Nama sumber data. Format: {datasource.name=accounts/{account}/dataSources/{datasource}}
data_source_id

int64

Hanya output. ID sumber data.
display_name

string

Wajib. Nama sumber data yang ditampilkan di UI Merchant Center.
input

Input

Hanya output. Menentukan jenis input ke sumber data. Berdasarkan input ini, beberapa setelan mungkin tidak berfungsi. Hanya sumber data generik yang dapat dibuat melalui API.
file_input

FileInput

Opsional. Kolom ini hanya digunakan jika data dikelola melalui file.
Kolom union Type. Jenis sumber data. Type hanya ada berupa salah satu diantara berikut:
primary_product_data_source

PrimaryProductDataSource

Wajib. Sumber data utama untuk produk lokal dan online.
supplemental_product_data_source

SupplementalProductDataSource

Wajib. Sumber data tambahan untuk produk lokal dan online.
local_inventory_data_source

LocalInventoryDataSource

Wajib. Sumber data inventaris lokal.
regional_inventory_data_source

RegionalInventoryDataSource

Wajib. Sumber data inventaris regional.
promotion_data_source

PromotionDataSource

Wajib. Sumber data promosi.

Input

Menentukan jenis input ke sumber data. Berdasarkan input ini, beberapa setelan mungkin tidak didukung.

Enum
INPUT_UNSPECIFIED Input belum ditetapkan.
API Menampilkan sumber data yang sebagian besar datanya disediakan melalui API.
FILE Menampilkan sumber data yang sebagian besar datanya disediakan melalui input file. Data masih dapat disediakan melalui API.
UI

Sumber data untuk produk yang ditambahkan langsung di Merchant Center.

Jenis sumber data ini tidak dapat dibuat atau diperbarui melalui API ini hanya dengan UI Merchant Center.

Jenis sumber data ini bersifat hanya baca.
AUTOFEED Hal ini juga disebut sebagai Feed otomatis yang digunakan untuk membuat data produk Anda secara otomatis. Jenis sumber data ini dapat diaktifkan atau dinonaktifkan melalui paket Akun.

DeleteDataSourceRequest

Pesan permintaan untuk metode DeleteDataSource.

Kolom
name

string

Wajib. Nama sumber data yang akan dihapus. Format: accounts/{account}/dataSources/{datasource}

FetchDataSourceRequest

Pesan permintaan untuk metode FetchDataSource.

Kolom
name

string

Wajib. Nama resource sumber data yang akan diambil. Format: accounts/{account}/dataSources/{datasource}

FileInput

Data khusus untuk sumber data file. Kolom ini kosong untuk input sumber data lainnya.

Kolom
fetch_settings

FetchSettings

Opsional. Ambil detail untuk mengirimkan sumber data. File ini berisi setelan untuk jenis input file FETCH dan GOOGLE_SHEETS. Kolom yang wajib diisi bervariasi berdasarkan frekuensi pengambilan.
file_name

string

Opsional. Nama file sumber data. Diperlukan untuk jenis input file UPLOAD.
file_input_type

FileInputType

Hanya output. Jenis input file.

FetchSettings

Ambil detail untuk mengirimkan sumber data.

Kolom
enabled

bool

Opsional. Mengaktifkan atau menjeda jadwal pengambilan.
day_of_month

int32

Opsional. Hari dalam sebulan saat file sumber data harus diambil (1-31). Kolom ini hanya dapat ditetapkan untuk frekuensi bulanan.
time_of_day

TimeOfDay

Opsional. Jam saat file sumber data harus diambil. Menit dan detik tidak didukung dan akan diabaikan.
day_of_week

DayOfWeek

Opsional. Hari dalam seminggu saat file sumber data harus diambil. Kolom ini hanya dapat ditetapkan untuk frekuensi mingguan.
time_zone

string

Opsional. Zona waktu yang digunakan untuk jadwal. UTC secara default. Misalnya, "America/Los_Angeles".
frequency

Frequency

Wajib. Frekuensi yang menjelaskan jadwal pengambilan.
fetch_uri

string

Opsional. URL tempat file sumber data dapat diambil. Google Merchant Center mendukung upload terjadwal otomatis menggunakan protokol HTTP, HTTPS, atau SFTP, sehingga nilainya harus berupa link yang valid menggunakan salah satu dari ketiga protokol tersebut. Tidak dapat diubah untuk file Google Spreadsheet.
username

string

Opsional. Nama pengguna opsional untuk [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Digunakan untuk mengirimkan sumber data melalui SFTP.
password

string

Opsional. Sandi opsional untuk [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Digunakan untuk mengirimkan sumber data melalui SFTP.

Frekuensi

Kolom yang wajib diisi bervariasi berdasarkan frekuensi pengambilan. Untuk jadwal pengambilan bulanan, [hari dalam sebulan][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] dan [jam][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] wajib diisi. Untuk jadwal pengambilan mingguan, [hari dalam seminggu][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] dan [jam kerja][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] wajib diisi. Untuk jadwal pengambilan harian, hanya [jam][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] yang diperlukan.

Enum
FREQUENCY_UNSPECIFIED Frekuensi tidak ditentukan.
FREQUENCY_DAILY Pengambilan terjadi setiap hari.
FREQUENCY_WEEKLY Pengambilan terjadi setiap minggu.
FREQUENCY_MONTHLY Pengambilan terjadi setiap bulan.

FileInputType

Metode pengiriman file.

Enum
FILE_INPUT_TYPE_UNSPECIFIED Jenis input file belum ditentukan.
UPLOAD File diupload melalui SFTP, Google Cloud Storage, atau secara manual di Merchant Center.
FETCH File ini diambil dari [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] yang dikonfigurasi.
GOOGLE_SHEETS File ini diambil dari Google Spreadsheet yang ditentukan di [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri].

GetDataSourceRequest

Pesan permintaan untuk metode GetDataSource.

Kolom
name

string

Wajib. Nama sumber data yang akan diambil. Format: accounts/{account}/dataSources/{datasource}

ListDataSourcesRequest

Pesan permintaan untuk metode ListDataSources.

Kolom
parent

string

Wajib. Akun yang mencantumkan sumber datanya. Format: accounts/{account}
page_size

int32

Opsional. Jumlah maksimum sumber data yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Nilai maksimum adalah 1.000; nilai di atas 1.000 akan dikonversi menjadi 1.000. Jika tidak ditentukan, jumlah maksimum sumber data akan ditampilkan.
page_token

string

Opsional. Token halaman, yang diterima dari panggilan ListDataSources sebelumnya. Berikan atribut ini untuk mengambil halaman selanjutnya.

Saat memberi nomor halaman, semua parameter lain yang diberikan ke ListDataSources harus cocok dengan panggilan yang menyediakan token halaman.

ListDataSourcesResponse

Pesan respons untuk metode ListDataSources.

Kolom
data_sources[]

DataSource

Sumber data dari akun yang ditentukan.
next_page_token

string

Token, yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak ada halaman berikutnya.

LocalInventoryDataSource

Sumber data inventaris lokal.

Kolom
feed_label

string

Wajib. Tidak dapat diubah. Label feed penawaran yang menyediakan inventaris lokal.

Harus kurang dari atau sama dengan 20 huruf besar (A-Z), angka (0-9), dan tanda hubung (-).

Lihat juga migrasi ke label feed.
content_language

string

Wajib. Tidak dapat diubah. Bahasa dua huruf ISO 639-1 untuk item yang disediakan inventaris lokal.

PrimaryProductDataSource

Sumber data utama untuk produk lokal dan online.

Kolom
channel

Channel

Wajib. Tidak dapat diubah. Menentukan jenis saluran sumber data.
countries[]

string

Opsional. Negara tempat item dapat ditampilkan. Direpresentasikan sebagai kode wilayah CLDR.
feed_label

string

Opsional. Tidak dapat diubah. Label feed yang ditentukan di tingkat sumber data.

Harus kurang dari atau sama dengan 20 huruf besar (A-Z), angka (0-9), dan tanda hubung (-).

Lihat juga migrasi ke label feed.

feedLabel dan contentLanguage harus disetel atau tidak disetel untuk sumber data dengan jenis konten produk. Parameter harus ditetapkan untuk sumber data dengan input file.

Jika ditetapkan, sumber data hanya akan menerima produk yang cocok dengan kombinasi ini. Jika tidak disetel, sumber data akan menerima produk tanpa batasan tersebut.
content_language

string

Opsional. Tidak dapat diubah. Bahasa dua huruf ISO 639-1 untuk item di sumber data.

feedLabel dan contentLanguage harus disetel atau tidak disetel. Penetapan kolom hanya dapat dibatalkan untuk sumber data tanpa input file.

Jika ditetapkan, sumber data hanya akan menerima produk yang cocok dengan kombinasi ini. Jika tidak disetel, sumber data akan menerima produk tanpa batasan tersebut.

Channel

Saluran Sumber Data.

Saluran digunakan untuk membedakan di antara sumber data untuk berbagai vertical produk.

Enum
CHANNEL_UNSPECIFIED Tidak ditentukan.
ONLINE_PRODUCTS Produk online.
LOCAL_PRODUCTS Produk lokal.
PRODUCTS Sumber data terpadu untuk produk lokal dan online.

PromotionDataSource

Sumber data promosi.

Kolom
target_country

string

Wajib. Tidak dapat diubah. Negara target yang digunakan sebagai bagian dari ID unik. Direpresentasikan sebagai kode wilayah CLDR.

Promosi hanya tersedia di negara yang dipilih.
content_language

string

Wajib. Tidak dapat diubah. Bahasa dua huruf ISO 639-1 untuk item di sumber data.

RegionalInventoryDataSource

Sumber data inventaris regional.

Kolom
feed_label

string

Wajib. Tidak dapat diubah. Label feed dari penawaran yang menyediakan inventaris regional.

Harus kurang dari atau sama dengan 20 huruf besar (A-Z), angka (0-9), dan tanda hubung (-).

Lihat juga migrasi ke label feed.
content_language

string

Wajib. Tidak dapat diubah. Bahasa dua huruf ISO 639-1 untuk item yang disediakan inventaris regional.

SupplementalProductDataSource

Sumber data tambahan untuk produk lokal dan online.

Kolom
feed_label

string

Opsional. Tidak dapat diubah. Label feed yang ditentukan di tingkat sumber data.

Harus kurang dari atau sama dengan 20 huruf besar (A-Z), angka (0-9), dan tanda hubung (-).

Lihat juga migrasi ke label feed.

feedLabel dan contentLanguage harus disetel atau tidak disetel untuk sumber data dengan jenis konten produk. Parameter harus ditetapkan untuk sumber data dengan input file.

Jika ditetapkan, sumber data hanya akan menerima produk yang cocok dengan kombinasi ini. Jika tidak disetel, sumber data akan menerima produk tanpa batasan tersebut.
content_language

string

Opsional. Tidak dapat diubah. Bahasa dua huruf ISO 639-1 untuk item di sumber data.

feedLabel dan contentLanguage harus disetel atau tidak disetel. Penetapan kolom hanya dapat dibatalkan untuk sumber data tanpa input file.

Jika ditetapkan, sumber data hanya akan menerima produk yang cocok dengan kombinasi ini. Jika tidak disetel, sumber data akan menerima produk tanpa batasan tersebut.

UpdateDataSourceRequest

Pesan permintaan untuk metode UpdateDataSource.

Kolom
data_source

DataSource

Wajib. Resource sumber data yang akan diperbarui.
update_mask

FieldMask

Wajib. Daftar kolom sumber data yang akan diperbarui.

Kolom yang ditentukan dalam mask pembaruan tanpa nilai yang ditentukan dalam isi akan dihapus dari sumber data.

Memberikan nilai "*" khusus untuk penggantian sumber data lengkap tidak didukung.