REST Resource: accounts.products

Kaynak: Ürün

Kurallar ve ek veri kaynakları uygulandıktan sonra birden fazla product inputs'ten oluşturulan işlenmiş ürün. İşlenen bu ürün, Merchant Center hesabınızda, Alışveriş reklamlarında ve Google'daki diğer platformlarda gösterilenlerle eşleşir. Her ürün, tam olarak bir birincil veri kaynağı ürün girişinden ve birden fazla ek veri kaynağı girişinden oluşur. Bir ürün girişi ekledikten, güncelledikten veya sildikten sonra, güncellenmiş ve işlenmiş ürünün alınabilmesi birkaç dakika sürebilir.

İşlenen ürün ve alt mesajlarındaki tüm alanlar, bazı istisnalar dışında Ürün verileri spesifikasyonundaki ilgili özelliklerin adıyla eşleşir.

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

string

Ürünün adı. Biçim: "{product.name=accounts/{account}/products/{product}}" (product son bölümü 4 bölümden oluşur: channel~contentLanguage~feedLabel~offerId. Ürün adı örneği: "accounts/123/products/online~tr~TR~sku123")
channel

enum (ChannelEnum)

Yalnızca çıkış. Ürünün kanalı.
offerId

string

Yalnızca çıkış. Ürününüz için benzersiz tanımlayıcınız. Bu durum, ürün girişi ve işlenmiş ürün için aynıdır. Baştaki ve sondaki boşluklar kaldırılır ve birden fazla boşluk tek bir boşlukla değiştirilir. Ayrıntılar için ürün verileri spesifikasyonuna bakın.
contentLanguage

string

Yalnızca çıkış. Ürünün iki harfli ISO 639-1 dil kodu.
feedLabel

string

Yalnızca çıkış. Ürünün feed etiketi.
dataSource

string

Yalnızca çıkış. Ürünün birincil veri kaynağı.
attributes

object (Attributes)

Yalnızca çıkış. Ürün özelliklerinin listesi.
customAttributes[]

object (CustomAttribute)

Yalnızca çıkış. Özel (satıcı tarafından sağlanan) özelliklerin listesi. Veri spesifikasyonunun herhangi bir özelliğini genel biçiminde (ör. { "name": "size type", "value": "regular" }) göndermek için de kullanılabilir. Bu, API tarafından açıkça gösterilmeyen özellikleri (ör. Google ile Satın Al için kullanılan ek özellikler) göndermek için kullanışlıdır.
productStatus

object (ProductStatus)

Yalnızca çıkış. Ürünün durumu, veri doğrulama sorunları, yani bir ürünle ilgili olarak eşzamansız olarak hesaplanan bilgiler.
versionNumber

string (int64 format)

Yalnızca çıkış. Ürünün mevcut sürümünü (tazeliğini) temsil eder. Aynı anda birden fazla güncelleme yapıldığında doğru sırayı korumak için kullanılabilir.

Ayarlanırsa sürüm numarası mevcut ürünün mevcut sürüm numarasından düşük olduğunda ekleme engellenir. Yeniden ekleme (örneğin, 30 gün sonra ürün yenileme) mevcut versionNumber ile yapılabilir.

Yalnızca birincil veri kaynaklarına eklemeler için desteklenir.

İşlem engellenirse iptal edilen istisna atılır.

ProductStatus

Ürünün durumu, veri doğrulama sorunları, yani bir ürünle ilgili olarak eşzamansız olarak hesaplanan bilgiler.

JSON gösterimi 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Alanlar
destinationStatuses[]

object (DestinationStatus)

Ürünün hedeflenen hedefleri.
itemLevelIssues[]

object (ItemLevelIssue)

Ürünle ilişkili tüm sorunların listesi.
creationDate

string (Timestamp format)

Öğenin oluşturulduğu tarih (ISO 8601 biçiminde).
lastUpdateDate

string (Timestamp format)

Öğenin en son güncellendiği tarih (ISO 8601 biçiminde).
googleExpirationDate

string (Timestamp format)

Öğenin süresinin dolan tarihi (ISO 8601 biçiminde).

DestinationStatus

Ürün durumunun hedef durumu.

JSON gösterimi 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Alanlar
reportingContext

enum (ReportingContextEnum)

Raporlama bağlamının adı.
approvedCountries[]

string

Teklifin onaylandığı ülke kodlarının (ISO 3166-1 alpha-2) listesi.
pendingCountries[]

string

Teklifin onay beklediği ülke kodlarının (ISO 3166-1 alpha-2) listesi.
disapprovedCountries[]

string

Teklifin onaylanmadığı ülke kodlarının (ISO 3166-1 alpha-2) listesi.

ItemLevelIssue

Ürün durumunun ItemLevelIssue özelliği.

JSON gösterimi 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Alanlar
code

string

Sorunun hata kodu.
severity

enum (Severity)

Bu sorunun teklifin yayınlanmasını nasıl etkilediği.
resolution

string

Sorunun satıcı tarafından çözülüp çözülemeyeceği.
attribute

string

Sorun tek bir özellikten kaynaklanıyorsa özelliğin adı.
reportingContext

enum (ReportingContextEnum)

Sorunun geçerli olduğu raporlama bağlamı.
description

string

İngilizce olarak kısa bir sorun açıklaması.
detail

string

İngilizce olarak ayrıntılı bir sorun açıklaması.
documentation

string

Bu sorunun çözülmesine yardımcı olacak bir web sayfasının URL'si.
applicableCountries[]

string

Sorunun teklif için geçerli olduğu ülke kodlarının (ISO 3166-1 alpha-2) listesi.

Önem derecesi

Sorunun ürünün yayınlanmasını nasıl etkilediği.

Sıralamalar
SEVERITY_UNSPECIFIED Belirtilmedi.
NOT_IMPACTED Bu sorun bir uyarı niteliğindedir ve ürünü doğrudan etkilemez.
DEMOTED Ürünün sıralaması düşürüldü ve büyük olasılıkla arama sonuçlarında sınırlı performans gösteriyor
DISAPPROVED Sorun nedeniyle ürün onaylanmaz.

Yöntemler

get

 İşlenen ürünü Merchant Center hesabınızdan alır.

list

 Merchant Center hesabınızda işlenen ürünleri listeler.