REST Resource: accounts.productReviews

Kaynak: ProductReview

Bir ürün için yorum. Daha fazla bilgi için Ürün Yorumu Feed'lerine Giriş başlıklı makaleyi inceleyin.

JSON gösterimi
{
  "name": string,
  "productReviewId": string,
  "attributes": {
    object (ProductReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "productReviewStatus": {
    object (ProductReviewStatus)
  }
}
Alanlar
name

string

Tanımlayıcı. Ürün yorumunun adı. Biçim: "{productreview.name=accounts/{account}/productReviews/{productReview}}"

productReviewId

string

Zorunlu. Yayıncının sistemindeki ürün yorumuna ait kalıcı ve benzersiz tanımlayıcı.

attributes

object (ProductReviewAttributes)

İsteğe bağlı. Ürün yorumu özelliklerinin listesi.

customAttributes[]

object (CustomAttribute)

İsteğe bağlı. Özel (satıcı tarafından sağlanan) özelliklerin listesi.

dataSource

string

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

productReviewStatus

object (ProductReviewStatus)

Yalnızca çıkış. Ürün yorumunun durumu, veri doğrulama sorunları, yani asynkron olarak hesaplanan ürün yorumu bilgileri.

ProductReviewAttributes

Özellikler.

JSON gösterimi
{
  "reviewTime": string,
  "pros": [
    string
  ],
  "cons": [
    string
  ],
  "reviewLink": {
    object (ReviewLink)
  },
  "reviewerImageLinks": [
    string
  ],
  "productNames": [
    string
  ],
  "productLinks": [
    string
  ],
  "asins": [
    string
  ],
  "gtins": [
    string
  ],
  "mpns": [
    string
  ],
  "skus": [
    string
  ],
  "brands": [
    string
  ],
  "collectionMethod": enum (CollectionMethod),
  "transactionId": string,
  "aggregatorName": string,
  "subclientName": string,
  "publisherName": string,
  "publisherFavicon": string,
  "reviewerId": string,
  "reviewerIsAnonymous": boolean,
  "reviewerUsername": string,
  "reviewLanguage": string,
  "reviewCountry": string,
  "title": string,
  "content": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "isSpam": boolean
}
Alanlar
reviewTime

string (Timestamp format)

Zorunlu. Yorumun ne zaman yazıldığını gösteren zaman damgası.

pros[]

string

İsteğe bağlı. Yorumcuya göre avantajları içerir. Yorumcu tarafından yazılmadığı sürece "pro:" gibi şablon metinleri çıkarın.

cons[]

string

İsteğe bağlı. Yorumcuya göre dezavantajları içerir. İnceleyen tarafından yazılmamışsa "con:" gibi ortak metin kullanmayın.

productNames[]

string

İsteğe bağlı. Bir ürünün açıklayıcı adı.

asins[]

string

İsteğe bağlı. Bir ürünle ilişkili ASIN'leri (Amazon Standart Kimlik Numaraları) içerir.

gtins[]

string

İsteğe bağlı. Bir ürünle ilişkili GTIN'leri (global ticari öğe numaraları) içerir. GTIN alt türleri (ör. UPC, EAN, ISBN, JAN) desteklenir.

mpns[]

string

İsteğe bağlı. Bir ürünle ilişkili MPN'leri (üretici parça numaraları) içerir.

skus[]

string

İsteğe bağlı. Bir ürünle ilişkili SKU'ları (stok tutma birimleri) içerir. Bu, genellikle ürün feed'indeki ürün teklif kimliğiyle eşleşir.

brands[]

string

İsteğe bağlı. Bir ürünle ilişkili marka adlarını içerir.

collectionMethod

enum (CollectionMethod)

İsteğe bağlı. İncelemenin toplanması için kullanılan yöntem.

transactionId

string

İsteğe bağlı. Yayıncının sistemindeki yorumla ilişkili işlem için kalıcı ve benzersiz bir tanımlayıcı. Bu kimlik, birden fazla yorumun aynı işlemle ilişkili olduğunu belirtmek için kullanılabilir.

aggregatorName

string

İsteğe bağlı. Ürün yorumlarını toplayan kaynağın adı.

Yayıncılar, yorumları yönetmek ve feed'leri sağlamak için yorum toplayıcı kullanabilir. Bu öğe, bir toplayıcının kullanıldığını belirtir ve toplayıcıyla ilgili bilgileri içerir.

subclientName

string

İsteğe bağlı. Ürün yorumlarının alt müşterisinin adı.

Alt müşteri, ürün yorumu kaynağının tanımlayıcısıdır. Dosya veri kaynağı yolunda sağlanan dizinle eşdeğer olmalıdır.

publisherName

string

İsteğe bağlı. Ürün yorumlarının yayıncısının adı.

Perakendeci, üretici, yorum hizmeti şirketi veya ürün yorumları yayınlayan herhangi bir tüzel kişi olabilecek yayıncı hakkındaki bilgiler.

publisherFavicon

string

İsteğe bağlı. Yayıncının şirket favicon'unun bağlantısı. Resim boyutları, favicon boyutunda (16x16 piksel) olmalıdır. Resim biçimi GIF, JPG veya PNG olmalıdır.

reviewerId

string

İsteğe bağlı. Ürün yorumunun yazarı.

Yayıncının sistemindeki yorumun yazarı için kalıcı ve benzersiz bir tanımlayıcı.

reviewerIsAnonymous

boolean

İsteğe bağlı. Yorumcu anonim kalacaksa doğru değerine ayarlayın.

reviewerUsername

string

İsteğe bağlı. Ürün yorumunu yorumlayan kişinin adı.

reviewLanguage

string

İsteğe bağlı. BCP-47 dil koduyla tanımlanan yorumun dili.

reviewCountry

string

İsteğe bağlı. ISO 3166-1 Alfa-2 ülke koduyla tanımlanan, yorumun yapıldığı ülke.

title

string

İsteğe bağlı. Yorumun başlığı.

content

string

Zorunlu. Yorumun içeriği.

minRating

string (int64 format)

İsteğe bağlı. Yorumla ilişkili puanları içerir. Puan için mümkün olan minimum sayı. Bu, mümkün olan en kötü değerlendirme olmalı ve puan içermeyen bir değer olmamalıdır.

maxRating

string (int64 format)

İsteğe bağlı. Derecelendirme için mümkün olan maksimum sayı. Maksimum puanın değeri, minimum özelliğinin değerinden büyük olmalıdır.

rating

number

İsteğe bağlı. Yorum yapan kullanıcının ürüne verdiği genel puan.

isSpam

boolean

İsteğe bağlı. Yorumun yayıncının sisteminde spam olarak işaretlenip işaretlenmediğini belirtir.

Tür

Yorum URI'sinin türü.

Sıralamalar
TYPE_UNSPECIFIED Tür belirtilmedi.
SINGLETON Yorum sayfasında yalnızca bu yorum yer alır.
GROUP Yorum sayfasında bu yorum da dahil olmak üzere bir grup yorum bulunur.

CollectionMethod

Yorum toplamak için kullanılan yöntem.

Sıralamalar
COLLECTION_METHOD_UNSPECIFIED Toplama yöntemi belirtilmemiş.
UNSOLICITED Kullanıcı, yorumu gönderirken belirli bir isteğe yanıt vermiyordu.
POST_FULFILLMENT Kullanıcı, siparişi yerine getirildikten sonra bir istek üzerine yorum göndermiştir.

ProductReviewStatus

Ürün inceleme durumu.

JSON gösterimi
{
  "destinationStatuses": [
    {
      object (ProductReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ProductReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
Alanlar
destinationStatuses[]

object (ProductReviewDestinationStatus)

Yalnızca çıkış. Ürün yorumunun amaçlanan hedefleri.

itemLevelIssues[]

object (ProductReviewItemLevelIssue)

Yalnızca çıkış. Ürün incelemesiyle ilişkili tüm sorunların listesi.

createTime

string (Timestamp format)

Yalnızca çıkış. Öğenin oluşturulduğu tarih (ISO 8601 biçiminde).

lastUpdateTime

string (Timestamp format)

Yalnızca çıkış. Öğenin son güncellendiği tarih (ISO 8601 biçiminde).

ProductReviewDestinationStatus

Ürün inceleme durumunun hedef durumu.

JSON gösterimi
{
  "reportingContext": enum (ReportingContextEnum)
}
Alanlar
reportingContext

enum (ReportingContextEnum)

Yalnızca çıkış. Raporlama bağlamının adı.

ProductReviewItemLevelIssue

Ürün inceleme 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
}
Alanlar
code

string

Yalnızca çıkış. Sorunun hata kodu.

severity

enum (Severity)

Yalnızca çıkış. Bu sorunun ürün yorumunun yayınlanmasını nasıl etkilediği.

resolution

string

Yalnızca çıkış. Sorunun satıcı tarafından çözülüp çözülemeyeceği.

attribute

string

Yalnızca çıkış. Sorun tek bir özellikten kaynaklanıyorsa özelliğin adı.

reportingContext

enum (ReportingContextEnum)

Yalnızca çıkış. Sorunun geçerli olduğu raporlama bağlamı.

description

string

Yalnızca çıkış. İngilizce olarak kısa bir sorun açıklaması.

detail

string

Yalnızca çıkış. İngilizce olarak ayrıntılı bir sorun açıklaması.

documentation

string

Yalnızca çıkış. Bu sorunun çözümüne yardımcı olacak bir web sayfasının URL'si.

Önem derecesi

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

Sıralamalar
SEVERITY_UNSPECIFIED Belirtilmedi.
NOT_IMPACTED Bu sorun bir uyarı niteliğindedir ve ürün yorumunu doğrudan etkilemez.
DISAPPROVED Sorun nedeniyle ürün incelemesi onaylanmadı.

Yöntemler

delete

Bir ürün yorumunu siler.

get

Ürün yorumu alır.

insert

Bir ürün yorumu ekler.

list

Ürün yorumlarını listeler.