REST Resource: accounts.dataSources

Resource: DataSource

Sumber data untuk akun Merchant Center.

Representasi JSON 
{
  "name": string,
  "dataSourceId": string,
  "displayName": string,
  "input": enum (Input),
  "fileInput": {
    object (FileInput)
  },

  // Union field Type can be only one of the following:
  "primaryProductDataSource": {
    object (PrimaryProductDataSource)
  },
  "supplementalProductDataSource": {
    object (SupplementalProductDataSource)
  },
  "localInventoryDataSource": {
    object (LocalInventoryDataSource)
  },
  "regionalInventoryDataSource": {
    object (RegionalInventoryDataSource)
  },
  "promotionDataSource": {
    object (PromotionDataSource)
  },
  "productReviewDataSource": {
    object (ProductReviewDataSource)
  },
  "merchantReviewDataSource": {
    object (MerchantReviewDataSource)
  }
  // End of list of possible types for union field Type.
}
Kolom
name

string

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

string (int64 format)

Hanya output. ID sumber data.
displayName

string

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

enum (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.
fileInput

object (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:
primaryProductDataSource

object (PrimaryProductDataSource)

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

object (SupplementalProductDataSource)

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

object (LocalInventoryDataSource)

Wajib. Sumber data inventaris lokal.
regionalInventoryDataSource

object (RegionalInventoryDataSource)

Wajib. Sumber data inventaris regional.
promotionDataSource

object (PromotionDataSource)

Wajib. Sumber data promosi.
productReviewDataSource

object (ProductReviewDataSource)

Wajib. Sumber data ulasan produk.
merchantReviewDataSource

object (MerchantReviewDataSource)

Wajib. Sumber data ulasan penjual.

PrimaryProductDataSource

Sumber data utama untuk produk lokal dan online.

Representasi JSON 
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "defaultRule": {
    object (DefaultRule)
  },
  "feedLabel": string,
  "contentLanguage": string
}
Kolom
channel

enum (Channel)

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

string

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

object (DefaultRule)

Opsional. Pengelolaan aturan default sumber data. Jika ditetapkan, sumber data yang ditautkan akan diganti.
feedLabel

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. Kolom ini 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.
contentLanguage

string

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

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

Representasi JSON 
{
  "takeFromDataSources": [
    {
      object (DataSourceReference)
    }
  ]
}
Kolom
takeFromDataSources[]

object (DataSourceReference)

Wajib. Daftar sumber data yang ditautkan di aturan default. Daftar ini diurutkan berdasarkan prioritas aturan default untuk menggabungkan data. Data ini mungkin tidak menyertakan satu pun atau 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.

DataSourceReference

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

Representasi JSON 
{

  // Union field data_source_id can be only one of the following:
  "self": boolean,
  "primaryDataSourceName": string,
  "supplementalDataSourceName": string
  // End of list of possible types for union field data_source_id.
}
Kolom

Kolom union data_source_id.

data_source_id hanya dapat berupa salah satu dari hal berikut:
self

boolean

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

string

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

string

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

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.

Representasi JSON 
{
  "referencingPrimaryDataSources": [
    {
      object (DataSourceReference)
    }
  ],
  "feedLabel": string,
  "contentLanguage": string
}
Kolom
referencingPrimaryDataSources[]

object (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.
feedLabel

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. Kolom harus dibatalkan penetapannya untuk sumber data tanpa file input.

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

string

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

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

LocalInventoryDataSource

Sumber data inventaris lokal.

Representasi JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
Kolom
feedLabel

string

Wajib. Tidak dapat diubah. Label feed penawaran tempat inventaris lokal disediakan.

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

Lihat juga migrasi ke label feed.
contentLanguage

string

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

RegionalInventoryDataSource

Sumber data inventaris regional.

Representasi JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
Kolom
feedLabel

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

string

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

PromotionDataSource

Sumber data promosi.

Representasi JSON 
{
  "targetCountry": string,
  "contentLanguage": string
}
Kolom
targetCountry

string

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

Promosi hanya tersedia di negara tertentu.
contentLanguage

string

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

ProductReviewDataSource

Jenis ini tidak memiliki kolom.

Sumber data ulasan produk.

MerchantReviewDataSource

Jenis ini tidak memiliki kolom.

Sumber data ulasan penjual.

Input

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

Enum
INPUT_UNSPECIFIED Input belum ditetapkan.
API Merepresentasikan sumber data yang datanya terutama disediakan melalui API.
FILE Merepresentasikan sumber data yang datanya terutama 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 oleh 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.

FileInput

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

Representasi JSON 
{
  "fetchSettings": {
    object (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
Kolom
fetchSettings

object (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.
fileName

string

Opsional. Nama file sumber data. Wajib untuk jenis input file UPLOAD.
fileInputType

enum (FileInputType)

Hanya output. Jenis input file.

FetchSettings

Ambil detail untuk mengirimkan sumber data.

Representasi JSON 
{
  "enabled": boolean,
  "dayOfMonth": integer,
  "timeOfDay": {
    object (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
Kolom
enabled

boolean

Opsional. Mengaktifkan atau menjeda jadwal pengambilan.
dayOfMonth

integer

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

object (TimeOfDay)

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

enum (DayOfWeek)

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

string

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

enum (Frequency)

Wajib. Frekuensi yang menjelaskan jadwal pengambilan.
fetchUri

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.

TimeOfDay

Mewakili waktu. Tanggal dan zona waktu tidak signifikan atau ditentukan di tempat lain. API dapat memilih untuk memungkinkan detik kabisat. Jenis terkait adalah google.type.Date dan google.protobuf.Timestamp.

Representasi JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Kolom
hours

integer

Jam dalam format 24 jam. Harus lebih besar dari atau sama dengan 0 dan biasanya harus kurang dari atau sama dengan 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti waktu tutup bisnis.
minutes

integer

Menit dalam jam. Harus lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 59.
seconds

integer

Detik dalam menit. Harus lebih besar dari atau sama dengan 0 dan biasanya harus kurang dari atau sama dengan 59. API dapat mengizinkan nilai 60 jika memungkinkan lompatan-detik.
nanos

integer

Pecahan detik, dalam nanodetik. Harus lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 999.999.999.

DayOfWeek

Mewakili hari dalam seminggu.

Enum
DAY_OF_WEEK_UNSPECIFIED Hari dalam seminggu tidak ditentukan.
MONDAY Senin
TUESDAY Selasa
WEDNESDAY Rabu
THURSDAY Kamis
FRIDAY Jumat
SATURDAY Sabtu
SUNDAY Minggu

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 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 terjadi 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 [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] yang dikonfigurasi.
GOOGLE_SHEETS File diambil dari Google Spreadsheet yang ditentukan di [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri].

Metode

create

 Membuat konfigurasi sumber data baru untuk akun yang ditentukan.

delete

 Menghapus sumber data dari akun Merchant Center Anda.

fetch

 Melakukan pengambilan data dengan segera (bahkan di luar jadwal pengambilan) pada sumber data dari Akun Merchant Center Anda.

get

 Mengambil konfigurasi sumber data untuk akun tertentu.

list

 Mencantumkan konfigurasi untuk sumber data untuk akun yang diberikan.

patch

 Memperbarui konfigurasi sumber data yang ada.