Package google.shopping.merchant.reviews.v1beta

Dizin

MerchantReviewsService

Satıcı yorumlarını yönetmek için kullanılan hizmet.

DeleteMerchantReview

rpc DeleteMerchantReview(DeleteMerchantReviewRequest) returns (Empty)

Satıcı yorumunu siler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/content

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.
GetMerchantReview

rpc GetMerchantReview(GetMerchantReviewRequest) returns (MerchantReview)

Satıcı yorumu alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/content

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.
InsertMerchantReview

rpc InsertMerchantReview(InsertMerchantReviewRequest) returns (MerchantReview)

Merchant Center hesabınız için bir yorum ekler. Yorum zaten mevcutsa yeni örnekle değiştirilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/content

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.
ListMerchantReviews

rpc ListMerchantReviews(ListMerchantReviewsRequest) returns (ListMerchantReviewsResponse)

Satıcı yorumlarını listeler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/content

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

ProductReviewsService

Ürün yorumlarını yönetme hizmeti.

DeleteProductReview

rpc DeleteProductReview(DeleteProductReviewRequest) returns (Empty)

Bir ürün yorumunu siler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/content

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.
GetProductReview

rpc GetProductReview(GetProductReviewRequest) returns (ProductReview)

Ürün yorumu alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/content

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.
InsertProductReview

rpc InsertProductReview(InsertProductReviewRequest) returns (ProductReview)

Bir ürün yorumu ekler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/content

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.
ListProductReviews

rpc ListProductReviews(ListProductReviewsRequest) returns (ListProductReviewsResponse)

Ürün yorumlarını listeler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/content

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

DeleteMerchantReviewRequest

DeleteMerchantReview yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Satıcı yorumunun kimliği. Biçim: accounts/{account}/merchantReviews/{merchantReview}

DeleteProductReviewRequest

DeleteProductReview yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Ürün yorumunun kimliği. Biçim: accounts/{hesap}/productReviews/{ürün yorumu}

GetMerchantReviewRequest

GetMerchantReview yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Satıcı yorumunun kimliği. Biçim: accounts/{account}/merchantReviews/{merchantReview}

GetProductReviewRequest

GetProductReview yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Satıcı yorumunun kimliği. Biçim: accounts/{hesap}/productReviews/{ürün yorumu}

InsertMerchantReviewRequest

InsertMerchantReview yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Satıcı incelemesinin ekleneceği hesap. Biçim: accounts/{account}
merchant_review

MerchantReview

Zorunlu. Eklenecek satıcı yorumu.
data_source

string

Zorunlu. merchantreview biçiminin veri kaynağı: accounts/{account}/dataSources/{datasource}.

InsertProductReviewRequest

InsertProductReview yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Ürün yorumunun ekleneceği hesap. Biçim: accounts/{account}
product_review

ProductReview

Zorunlu. Eklenecek ürün yorumu.
data_source

string

Zorunlu. Biçim: accounts/{account}/dataSources/{datasource}.

ListMerchantReviewsRequest

ListMerchantsReview yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Satıcı yorumlarının listeleneceği hesap. Biçim: accounts/{account}
page_size

int32

İsteğe bağlıdır. Döndürülecek maksimum satıcı yorumu sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Maksimum değer 1.000'dür. 1.000'den yüksek değerler 1.000'e zorlanacaktır. Belirtilmemesi durumunda maksimum yorum sayısı döndürülür.
page_token

string

İsteğe bağlıdır. Önceki bir ListMerchantReviews çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalandırma yaparken ListMerchantReviews parametresine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListMerchantReviewsResponse

ListMerchantsReview yöntemi için yanıt mesajı.

Alanlar
merchant_reviews[]

MerchantReview

Satıcı yorumu.
next_page_token

string

Sonuçların bir sonraki sayfasını almak için kullanılan jeton.

ListProductReviewsRequest

ListProductReviews yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Ürün yorumlarının listeleneceği hesap. Biçim: accounts/{account}
page_size

int32

İsteğe bağlıdır. İade edilecek maksimum ürün sayısı. Hizmet bu değerden daha az sonuç döndürebilir.
page_token

string

İsteğe bağlıdır. Önceki bir ListProductReviews çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalandırma yaparken ListProductReviews parametresine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListProductReviewsResponse

ListProductReviews yöntemi için yanıt mesajı.

Alanlar
product_reviews[]

ProductReview

Ürün yorumu.
next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa olmaz.

MerchantReview

Satıcıyla ilgili yorum. Daha fazla bilgi için Satıcı Yorumu Feed'lerine Giriş başlıklı makaleyi inceleyin.

Alanlar
name

string

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

string

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

MerchantReviewAttributes

İsteğe bağlıdır. Satıcı yorumu özelliklerinin listesi.
custom_attributes[]

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şluklarla değiştirilir.
data_source

string

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

MerchantReviewStatus

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

MerchantReviewAttributes

Özellikler.

Alanlar
merchant_id

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ı belirtiyorsa bu isteklerin kimliği aynı olmalıdır.
merchant_display_name

string

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

int64

İsteğe bağlıdır. 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.
max_rating

int64

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

double

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

string

İsteğe bağlıdır. 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.
reviewer_id

string

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

string

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

bool

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

CollectionMethod

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

Timestamp

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

string

Zorunlu. BCP-47 dil koduyla tanımlanan yorumun dili.
review_country

string

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

CollectionMethod

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

Sıralamalar
COLLECTION_METHOD_UNSPECIFIED Toplama yöntemi belirtilmemiş.
MERCHANT_UNSOLICITED Kullanıcı, kendisinden talep edilmeden yorum göndermiş.
POINT_OF_SALE Kullanıcı, sipariş verdikten sonra kendisinden talep edildiği için yorum göndermiş.
AFTER_FULFILLMENT Kullanıcı, siparişi yerine getirildikten sonra kendisinden talep edildiği için yorum göndermiş.

MerchantReviewStatus

Satıcı yorumunun durumu, veri doğrulama sorunları, yani asynkron olarak hesaplanan bir satıcı yorumuyla ilgili bilgiler.

Alanlar
destination_statuses[]

MerchantReviewDestinationStatus

Yalnızca çıkış. Satıcı yorumunun hedeflenen varış noktaları.
item_level_issues[]

MerchantReviewItemLevelIssue

Yalnızca çıkış. Satıcı incelemesiyle ilişkili tüm sorunların listesi.
create_time

Timestamp

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

Timestamp

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

MerchantReviewDestinationStatus

Satıcı inceleme durumunun hedef durumu.

Alanlar
reporting_context

ReportingContextEnum

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

MerchantReviewItemLevelIssue

Satıcı inceleme durumunun ItemLevelIssue özelliği.

Alanlar
code

string

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

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ı.
reporting_context

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 onaylanmasını engeller.

ProductReview

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

Alanlar
name

string

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

string

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

ProductReviewAttributes

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

CustomAttribute

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

string

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

ProductReviewStatus

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

ProductReviewAttributes

Özellikler.

Alanlar
review_time

Timestamp

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

string

İsteğe bağlıdır. 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ıdır. Yorumcuya göre dezavantajları içerir. Yorumcu tarafından yazılmadığı sürece "eksi:" gibi şablon metinleri atlayın.
product_names[]

string

İsteğe bağlıdır. Ürünün açıklayıcı adı.
asins[]

string

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

string

İsteğe bağlıdır. 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ıdır. Bir ürünle ilişkili MPN'leri (üretici parça numaraları) içerir.
skus[]

string

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

string

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

CollectionMethod

İsteğe bağlıdır. Yorumu toplamak için kullanılan yöntem.
transaction_id

string

İsteğe bağlıdır. 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.
aggregator_name

string

İsteğe bağlıdır. Ü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.
subclient_name

string

İsteğe bağlıdır. Ü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.
publisher_name

string

İsteğe bağlıdır. Ü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.
publisher_favicon

string

İsteğe bağlıdır. 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.
reviewer_id

string

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

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

bool

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

string

İsteğe bağlıdır. Ürün yorumunu yazan kullanıcının adı.
review_language

string

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

string

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

string

İsteğe bağlıdır. Yorumun başlığı.
content

string

Zorunlu. Yorumun içeriği.
min_rating

int64

İsteğe bağlıdır. Yorumla ilişkili puanları içerir. 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.
max_rating

int64

İsteğe bağlıdır. Derecelendirme için mümkün olan maksimum sayı. Maksimum puan değerinin, minimum özellik değerinden büyük olması gerekir.
rating

double

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

bool

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

CollectionMethod

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

Sıralamalar
COLLECTION_METHOD_UNSPECIFIED Toplama yöntemi belirtilmemiş.
UNSOLICITED Kullanıcı, kendisinden talep edilmeden yorum göndermiş.
POST_FULFILLMENT Kullanıcı, siparişi yerine getirildikten sonra kendisinden talep edildiği için yorum göndermiş.

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.

ProductReviewStatus

Ürün incelemesi durumu.

Alanlar
destination_statuses[]

ProductReviewDestinationStatus

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

ProductReviewItemLevelIssue

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

Timestamp

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

Timestamp

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

ProductReviewDestinationStatus

Ürün inceleme durumunun hedef durumu.

Alanlar
reporting_context

ReportingContextEnum

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

ProductReviewItemLevelIssue

Ürün inceleme durumunun ItemLevelIssue özelliği.

Alanlar
code

string

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

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ı.
reporting_context

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 ü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ı.