REST Resource: accounts.products

Resource: Produk

Produk yang diproses, dibuat dari beberapa product inputs setelah menerapkan aturan dan sumber data tambahan. Produk yang diproses ini cocok dengan yang ditampilkan di akun Merchant Center Anda serta di iklan Shopping dan platform Google lainnya. Setiap produk dibuat dari tepat satu input produk sumber data utama, dan beberapa input sumber data tambahan. Setelah menyisipkan, memperbarui, atau menghapus input produk, mungkin perlu waktu beberapa menit sebelum produk yang diproses dan diperbarui dapat diambil.

Semua kolom dalam produk yang diproses dan sub-pesannya cocok dengan nama atribut yang sesuai di Spesifikasi data produk dengan beberapa pengecualian.

Representasi JSON 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
Kolom
name

string

Nama produk. Format: "{product.name=accounts/{account}/products/{product}}" dengan bagian terakhir product terdiri dari 4 bagian: channel~contentLanguage~feedLabel~offerId contoh untuk nama produk adalah "accounts/123/products/online~en~US~sku123"
channel

enum (ChannelEnum)

Hanya output. Saluran produk.
offerId

string

Hanya output. ID unik Anda untuk produk. Hal ini sama untuk input produk dan produk yang diproses. Spasi kosong di awal dan di akhir akan dihapus dan beberapa spasi kosong akan diganti dengan satu spasi kosong saat dikirim. Lihat spesifikasi data produk untuk mengetahui detailnya.
contentLanguage

string

Hanya output. Kode bahasa ISO 639-1 dua huruf untuk produk.
feedLabel

string

Hanya output. Label feed untuk produk.
dataSource

string

Hanya output. Sumber data utama produk.
attributes

object (Attributes)

Hanya output. Daftar atribut produk.
customAttributes[]

object (CustomAttribute)

Hanya output. Daftar atribut khusus (disediakan penjual). Atribut ini juga dapat digunakan untuk mengirimkan atribut spesifikasi data dalam bentuk generik (misalnya, { "name": "size type", "value": "regular" }). Hal ini berguna untuk mengirimkan atribut yang tidak ditampilkan secara eksplisit oleh API, seperti atribut tambahan yang digunakan untuk Beli dengan Google.
productStatus

object (ProductStatus)

Hanya output. Status produk, masalah validasi data, yaitu informasi tentang produk yang dihitung secara asinkron.
versionNumber

string (int64 format)

Hanya output. Merepresentasikan versi produk yang ada (keaktualan), yang dapat digunakan untuk mempertahankan urutan yang tepat saat beberapa pembaruan dilakukan secara bersamaan.

Jika ditetapkan, penyisipan akan dicegah jika nomor versi lebih rendah dari nomor versi saat ini dari produk yang ada. Penyisipan ulang (misalnya, pembaruan produk setelah 30 hari) dapat dilakukan dengan versionNumber saat ini.

Hanya didukung untuk penyisipan ke sumber data utama.

Jika operasi dicegah, pengecualian yang dibatalkan akan ditampilkan.

ProductStatus

Status produk, masalah validasi data, yaitu informasi tentang produk yang dihitung secara asinkron.

Representasi JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Kolom
destinationStatuses[]

object (DestinationStatus)

Tujuan yang dimaksudkan untuk produk.
itemLevelIssues[]

object (ItemLevelIssue)

Daftar semua masalah yang terkait dengan produk.
creationDate

string (Timestamp format)

Tanggal item dibuat, dalam format ISO 8601.
lastUpdateDate

string (Timestamp format)

Tanggal item terakhir diperbarui, dalam format ISO 8601.
googleExpirationDate

string (Timestamp format)

Tanggal berakhirnya masa berlaku item, dalam format ISO 8601.

DestinationStatus

Status tujuan status produk.

Representasi JSON 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Kolom
reportingContext

enum (ReportingContextEnum)

Nama konteks pelaporan.
approvedCountries[]

string

Daftar kode negara (ISO 3166-1 alpha-2) tempat penawaran disetujui.
pendingCountries[]

string

Daftar kode negara (ISO 3166-1 alpha-2) tempat penawaran menunggu persetujuan.
disapprovedCountries[]

string

Daftar kode negara (ISO 3166-1 alpha-2) tempat penawaran tidak disetujui.

ItemLevelIssue

ItemLevelIssue dari status produk.

Representasi JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Kolom
code

string

Kode error masalah.
severity

enum (Severity)

Pengaruh masalah ini terhadap penayangan penawaran.
resolution

string

Apakah masalah dapat diselesaikan oleh penjual.
attribute

string

Nama atribut, jika masalahnya disebabkan oleh satu atribut.
reportingContext

enum (ReportingContextEnum)

Konteks pelaporan tempat masalah diterapkan.
description

string

Deskripsi singkat masalah dalam bahasa Inggris.
detail

string

Deskripsi masalah mendetail dalam bahasa Inggris.
documentation

string

URL halaman web untuk membantu menyelesaikan masalah ini.
applicableCountries[]

string

Daftar kode negara (ISO 3166-1 alpha-2) tempat masalah berlaku untuk penawaran.

Keparahan

Pengaruh masalah terhadap penayangan produk.

Enum
SEVERITY_UNSPECIFIED Tidak ditentukan.
NOT_IMPACTED Masalah ini merupakan peringatan dan tidak berdampak langsung pada produk.
DEMOTED Produk diturunkan dan kemungkinan besar memiliki performa yang terbatas di hasil penelusuran
DISAPPROVED Masalah tidak menyetujui produk.

Metode

get

 Mengambil produk yang diproses dari akun Merchant Center Anda.

list

 Mencantumkan produk yang diproses di akun Merchant Center Anda.