REST Resource: accounts.merchantReviews

Kaynak: MerchantReview

Bir satıcı için yapılan yorum. Daha fazla bilgi için Satıcı Yorumu Feed'lerine Giriş başlıklı makaleyi inceleyin.

JSON gösterimi
{
  "name": string,
  "merchantReviewId": string,
  "attributes": {
    object (MerchantReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "merchantReviewStatus": {
    object (MerchantReviewStatus)
  }
}
Alanlar
name

string

Tanımlayıcı. Satıcı yorumunun adı. Biçim: "{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"

merchantReviewId

string

Zorunlu. Kullanıcı, satıcı yorumunu benzersiz bir şekilde tanımlamak için satıcı yorum kimliği sağladı.

attributes

object (MerchantReviewAttributes)

İsteğe bağlı. Satıcı yorumu özelliklerinin listesi.

customAttributes[]

object (CustomAttribute)

Zorunlu. Özel (satıcı tarafından sağlanan) özelliklerin listesi. Ayrıca, veri spesifikasyonunun herhangi bir özelliğini genel biçiminde (örneğin, { "name": "size type", "value": "regular" }) göndermek için de kullanılabilir. Bu, deneysel özellikler gibi API tarafından açıkça gösterilmeyen özellikleri göndermek için yararlıdır. Her özel özellik için izin verilen maksimum karakter sayısı 10.240'tür (ad ve değer için karakterlerin toplamını temsil eder). Ürün başına en fazla 2.500 özel özellik ayarlanabilir. Bu özelliklerin toplam boyutu 102, 4 KB'ı aşmamalıdır. Özel özellik adlarındaki alt çizgiler, eklendikten sonra boşlukla değiştirilir.

dataSource

string

Yalnızca çıkış. Satıcı yorumunun birincil veri kaynağı.

merchantReviewStatus

object (MerchantReviewStatus)

Yalnızca çıkış. Bir satıcı yorumunun durumu, veri doğrulama sorunları, yani eşzamansız olarak hesaplanan bir satıcı yorumuyla ilgili bilgiler.

MerchantReviewAttributes

Özellikler.

JSON gösterimi
{
  "merchantId": string,
  "merchantDisplayName": string,
  "merchantLink": string,
  "merchantRatingLink": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "title": string,
  "content": string,
  "reviewerId": string,
  "reviewerUsername": string,
  "isAnonymous": boolean,
  "collectionMethod": enum (CollectionMethod),
  "reviewTime": string,
  "reviewLanguage": string,
  "reviewCountry": string
}
Alanlar
merchantId

string

Zorunlu. Tüm isteklerde benzersiz ve sabit olmalıdır. Diğer bir deyişle, bugün yapılan bir istek ile 90 gün önce yapılan bir istek aynı satıcıyı referans alıyorsa aynı kimliğe sahip olmalıdır.

merchantDisplayName

string

İsteğe bağlı. Satıcının okunabilir görünen adı.

minRating

string (int64 format)

İsteğe bağlı. Puan için mümkün olan minimum sayı. Bu, mümkün olan en kötü puan olmalı ve puanlama olmaması için 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 değeri, minimum puan değerinden büyük olmalıdır.

rating

number

İsteğe bağlı. Yorum yapan kullanıcının satıcıya verdiği genel puan.

title

string

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

content

string

Zorunlu. Bu, kullanıcı tarafından sağlanan herhangi bir serbest biçimli metin olmalıdır ve kısaltılmamalıdır. Farklı sorulara birden fazla yanıt sağlanırsa yanıtların anlamlı olması için gereken minimum bağlamla birlikte tüm yanıtlar eklenmelidir. Sorular yanıtlanmamışsa bağlam bilgisi sağlanmamalıdır.

reviewerId

string

İsteğe bağlı. Yayıncının sistemindeki yorumun yazarı için kalıcı ve benzersiz bir tanımlayıcı.

reviewerUsername

string

İsteğe bağlı. Yorumu yazan kullanıcının görünen adı.

isAnonymous

boolean

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

collectionMethod

enum (CollectionMethod)

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

reviewTime

string (Timestamp format)

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

reviewLanguage

string

Zorunlu. BCP-47 dil kodu tarafından tanımlanan yorumun dilidir.

reviewCountry

string

İsteğe bağlı. İnceleme uzmanının siparişi verdiği ülke (ISO 3166-1 Alpha-2 ülke koduyla tanımlanır).

CollectionMethod

İncelemenin toplanması için kullanılan yöntem.

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

MerchantReviewStatus

Bir satıcı yorumunun durumu, veri doğrulama sorunları, yani eşzamansız olarak hesaplanan bir satıcı yorumuyla ilgili bilgiler.

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

object (MerchantReviewDestinationStatus)

Yalnızca çıkış. Satıcı yorumu için planlanan hedefler.

itemLevelIssues[]

object (MerchantReviewItemLevelIssue)

Yalnızca çıkış. Satıcı 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).

MerchantReviewDestinationStatus

Satıcı inceleme durumunun hedef durumu.

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

enum (ReportingContextEnum)

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

MerchantReviewItemLevelIssue

Satıcı yorum durumunun itemLevelIssue.

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 satıcı 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ülmesine yardımcı olacak bir web sayfasının URL'si.

Önem derecesi

Sorunun satıcı incelemesinin yayınlanmasını nasıl etkilediği.

Sıralamalar
SEVERITY_UNSPECIFIED Belirtilmedi.
NOT_IMPACTED Bu sorun bir uyarı niteliğindedir ve satıcı incelemesini doğrudan etkilemez.
DISAPPROVED Sorun, satıcı yorumunun onaylanmamasına neden oluyor.

Yöntemler

delete

Satıcı yorumunu siler.

get

Satıcı yorumu alır.

insert

Merchant Center hesabınız için bir yorum ekler.

list

Satıcı yorumlarını listeler.