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)
  }
  // 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 ini, 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 ada berupa salah satu diantara 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.

PrimaryProductDataSource

Sumber data utama untuk produk lokal dan online.

Representasi JSON 
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "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.
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. 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.
contentLanguage

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.

SupplementalProductDataSource

Sumber data tambahan untuk produk lokal dan online.

Representasi JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
Kolom
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. 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.
contentLanguage

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.

LocalInventoryDataSource

Sumber data inventaris lokal.

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

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

string

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

RegionalInventoryDataSource

Sumber data inventaris regional.

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

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

string

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

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

string

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

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.

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 wajib diisi bervariasi berdasarkan frekuensi pengambilan.
fileName

string

Opsional. Nama file sumber data. Diperlukan 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 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.

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 dari 0 hingga 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti waktu tutup bisnis.
minutes

integer

Menit dalam jam. Harus dari 0 hingga 59.
seconds

integer

Detik dalam waktu. Biasanya harus dari 0 hingga 59. API dapat mengizinkan nilai 60 jika memungkinkan lompatan-detik.
nanos

integer

Pecahan detik dalam nanodetik. Harus dari 0 hingga 999.999.999.

DayOfWeek

Merepresentasikan hari.

Enum
DAY_OF_WEEK_UNSPECIFIED Hari 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][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 [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] yang dikonfigurasi.
GOOGLE_SHEETS File ini 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 tertentu.

delete

 Menghapus sumber data dari akun Merchant Center Anda.

fetch

 Melakukan pengambilan data secara langsung (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 tertentu.

patch

 Memperbarui konfigurasi sumber data yang ada.