Package google.shopping.merchant.datasources.v1beta

Indeks

DataSourcesService

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

CreateDataSource

rpc CreateDataSource(CreateDataSourceRequest) returns (DataSource)

Membuat konfigurasi sumber data baru untuk akun yang ditentukan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

Melakukan pengambilan data dengan segera (bahkan di luar jadwal pengambilan) pada sumber data dari Akun Merchant Center Anda. Jika 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:

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

  • 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 yang diberikan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

FileUploadsService

Layanan untuk mengelola upload file sumber data.

GetFileUpload

rpc GetFileUpload(GetFileUploadRequest) returns (FileUpload)

Mendapatkan upload file sumber data terbaru. Hanya alias latest yang diterima untuk upload file.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • 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, 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 dapat berupa salah satu dari 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.
product_review_data_source

ProductReviewDataSource

Wajib. Sumber data ulasan produk.
merchant_review_data_source

MerchantReviewDataSource

Wajib. Sumber data ulasan penjual.

Input

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

Enum
INPUT_UNSPECIFIED Input tidak ditentukan.
API Merepresentasikan sumber data yang datanya terutama 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 dikenal sebagai Feed otomatis yang digunakan untuk membuat data produk Anda secara otomatis. Jenis sumber data ini dapat diaktifkan atau dinonaktifkan melalui paket Akun.

DataSourceReference

Referensi sumber data dapat digunakan untuk mengelola sumber data terkait dalam layanan sumber data.

Kolom

Kolom union data_source_id.

data_source_id hanya dapat berupa salah satu dari hal berikut:
self

bool

Self harus digunakan untuk mereferensikan sumber data utama itu sendiri.
primary_data_source_name

string

Opsional. Nama sumber data utama. Format: accounts/{account}/dataSources/{datasource}
supplemental_data_source_name

string

Opsional. Nama sumber data tambahan. Format: accounts/{account}/dataSources/{datasource}

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 diperlukan bervariasi berdasarkan frekuensi pengambilan.
file_name

string

Opsional. Nama file sumber data. Wajib 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 tiga 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 diperlukan bervariasi berdasarkan frekuensi pengambilan. Untuk jadwal pengambilan bulanan, [hari dalam sebulan][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] dan [jam dalam sehari][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] diperlukan. Untuk jadwal pengambilan mingguan, [hari dalam seminggu][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] dan [jam dalam sehari][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] diperlukan. 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 dilakukan setiap hari.
FREQUENCY_WEEKLY Pengambilan data dilakukan setiap minggu.
FREQUENCY_MONTHLY Pengambilan terjadi setiap bulan.

FileInputType

Metode pengiriman file.

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

FileUpload

Upload file sumber data tertentu, yaitu hasil pengambilan sumber data pada stempel waktu tertentu yang dihitung secara asinkron saat pemrosesan sumber data selesai. Hanya berlaku untuk sumber data file.

Kolom
name

string

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

int64

Hanya output. ID sumber data.
processing_state

ProcessingState

Hanya output. Status pemrosesan sumber data.
issues[]

Issue

Hanya output. Daftar masalah yang terjadi dalam sumber data.
items_total

int64

Hanya output. Jumlah item di sumber data yang diproses.
items_created

int64

Hanya output. Jumlah item dalam sumber data yang dibuat.
items_updated

int64

Hanya output. Jumlah item di sumber data yang diperbarui.
upload_time

Timestamp

Hanya output. Tanggal file sumber data diupload.

Masalah

Error yang terjadi di sumber data, seperti "harga tidak valid".

Kolom
title

string

Hanya output. Judul masalah, misalnya, "Item terlalu besar".
description

string

Hanya output. Deskripsi error, misalnya, "Sumber data Anda berisi item yang atributnya terlalu banyak atau terlalu besar. Item ini akan dihapus".
code

string

Hanya output. Kode error, misalnya, "validation/invalid_value". Menampilkan "?" jika kode tidak diketahui.
count

int64

Hanya output. Jumlah kemunculan error dalam upload file.
severity

Severity

Hanya output. Tingkat keparahan masalah.
documentation_uri

string

Hanya output. Link ke dokumentasi yang menjelaskan masalah secara lebih mendetail, jika tersedia.

Keparahan

Tingkat keparahan masalah.

Enum
SEVERITY_UNSPECIFIED Tingkat keparahan tidak ditentukan.
WARNING Masalahnya adalah peringatan.
ERROR Masalahnya adalah error.

ProcessingState

Status pemrosesan sumber data.

Enum
PROCESSING_STATE_UNSPECIFIED Status pemrosesan tidak ditentukan.
FAILED Sumber data tidak dapat diproses atau semua item mengalami error.
IN_PROGRESS Sumber data sedang diproses.
SUCCEEDED Sumber data berhasil diproses, meskipun beberapa item mungkin mengalami error.

GetDataSourceRequest

Pesan permintaan untuk metode GetDataSource.

Kolom
name

string

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

GetFileUploadRequest

Pesan permintaan untuk metode GetFileUploadRequest.

Kolom
name

string

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

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 maksimumnya 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, diterima dari panggilan ListDataSources sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

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

MerchantReviewDataSource

Jenis ini tidak memiliki kolom.

Sumber data ulasan penjual.

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

DefaultRule

Opsional. Pengelolaan aturan default sumber data. Jika ditetapkan, sumber data tertaut akan diganti.
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 ditetapkan atau tidak ditetapkan 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 ditetapkan, sumber data akan menerima produk tanpa batasan tersebut.
content_language

string

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

feedLabel dan contentLanguage harus disetel atau dibatalkan penetapannya. 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 ditetapkan, sumber data akan menerima produk tanpa batasan tersebut.

Saluran

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. Catatan: Pengelolaan produk melalui API tidak dapat dilakukan untuk saluran ini.

DefaultRule

Pengelolaan aturan default sumber data.

Kolom
take_from_data_sources[]

DataSourceReference

Wajib. Daftar sumber data yang ditautkan di aturan default. Daftar ini diurutkan berdasarkan prioritas aturan default untuk menggabungkan data. Ini mungkin tidak menyertakan atau menyertakan beberapa referensi ke self dan sumber data tambahan.

Daftar tidak boleh kosong.

Untuk menautkan sumber data ke aturan default, Anda perlu menambahkan referensi baru ke daftar ini (dalam urutan berurutan).

Untuk membatalkan tautan sumber data dari aturan default, Anda harus menghapus referensi yang diberikan dari daftar ini.

Mengubah urutan daftar ini akan menyebabkan perubahan prioritas sumber data di aturan default.

Misalnya, memberikan daftar berikut: [1001, self] akan mengambil nilai atribut dari sumber data tambahan 1001, dan kembali ke self jika atribut tidak ditetapkan di 1001.

ProductReviewDataSource

Jenis ini tidak memiliki kolom.

Sumber data ulasan produk.

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 ISO 639-1 dua huruf dari item di sumber data.

RegionalInventoryDataSource

Sumber data inventaris regional.

Kolom
feed_label

string

Wajib. Tidak dapat diubah. Label feed 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 ISO 639-1 dua huruf dari item yang inventaris regionalnya disediakan.

SupplementalProductDataSource

Sumber data tambahan untuk produk lokal dan online. Setelah pembuatan, Anda harus memastikan untuk menautkan sumber data produk tambahan ke satu atau beberapa sumber data produk utama.

Kolom
referencing_primary_data_sources[]

DataSourceReference

Hanya output. Daftar (tidak diurutkan dan dihapus duplikatnya) dari semua sumber data utama yang ditautkan ke sumber data ini dalam aturan default atau kustom. Sumber data tambahan tidak dapat dihapus sebelum semua link dihapus.
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 ditetapkan atau tidak ditetapkan untuk sumber data dengan jenis konten produk.

Nilai ini harus ditetapkan untuk sumber data dengan file input. Penetapan kolom untuk sumber data tanpa file input harus dibatalkan.

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

string

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

feedLabel dan contentLanguage harus disetel atau dibatalkan penetapannya. 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.