فروشندگان را با استفاده از Merchant API بررسی کنید

بررسی‌های فروشنده به افراد کمک می‌کند کسب‌وکارهایی را پیدا کنند که تجربیات مشتری باکیفیت را ارائه می‌دهند، به ایجاد اعتماد و امکان تصمیم‌گیری آگاهانه‌تر خرید کمک می‌کنند. در نتیجه، رتبه‌بندی فروشگاه‌ها می‌تواند به کسب‌وکارها کمک کند تا عملکرد تبلیغات و فهرست‌های ارگانیک را بهبود بخشند و مشتریان واجد شرایط بیشتری را به صفحات فرود خود سوق دهند.

این صفحه توضیح می دهد که چگونه می توانید نظرات فروشنده را با استفاده از Merchant API مدیریت کنید.

پیش نیازها

گوگل به شما نیاز دارد که اطلاعات خاصی را ارائه دهید. شما باید موارد زیر را داشته باشید:

  • منبع داده بازنگری فعال در Google Merchant Center.
  • حساب شما باید در برنامه رتبه بندی فروشگاه ثبت شود. اگر مطمئن نیستید که قبلا ثبت نام کرده اید، مرکز تجاری را بررسی کنید. اگر ثبت نام نکرده اید، فرم درخواست را ارسال کنید.

یک منبع داده ایجاد کنید

از datasource.create API برای ایجاد فید تبلیغاتی استفاده کنید. اگر فید تبلیغاتی موجود موجود است، از datasource.get برای واکشی datasource.name استفاده کنید.

فرم درخواست به شرح زیر است:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{accountId}/dataSources/{dataSourceId}

مثال

مثال یک درخواست و پاسخ معمولی را نشان می دهد.

درخواست کنید

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "merchantReviewDataSource":{} }

پاسخ

{
  "name": "accounts/123/dataSources/1000000573361824",
  "dataSourceId": "1000000573361824",
  "displayName": "test api feed",
  "merchantReviewDataSource": {},
  "input": "API"
}

ایجاد بررسی تجاری

می‌توانید از روش accounts.merchantreviews.insert برای ایجاد یا به‌روزرسانی نظر فروشنده استفاده کنید. روش accounts.merchantreviews.insert یک منبع merchantreview و نام منبع داده را به عنوان ورودی می گیرد. در صورت موفقیت، بازبینی تجاری جدید یا به‌روزرسانی شده را برمی‌گرداند. ایجاد یک بررسی تجاری به datasource.name نیاز دارد.

فرم درخواست:

POST https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/*/}merchantReviews:insert

نمونه بررسی بازرگان زیر را برای مرجع مطالعه کنید.

POST https://merchantapi.googleapis.com/reviews/v1beta/accounts/{accountId}/merchantReviews:insert?dataSource=accounts/{accountId}/dataSources/{dataSourceId}

  merchantReviewId = 'my_own_review'
  attributes {
    merchantId = 'merchant_id'
    merchantDisplayName = 'merchant_display_name'
    merchantLink = 'publisher_name'
    merchantRatingLink = 'https://www.google.com'
    minRating = 1
    maxRating = 10
    rating = 7.9
    title = 'Amazing Merchant'
    content = 'This is an incredible merchant'
    reviewerId = 'reviewer_id'
    reviewerUsername = 'reviewer_username'
    isAnonymous = false
    collectionMethod = 'AFTER_FULFILLMENT'
    reviewTime = '2024-04-01T00:00:00Z'
    reviewLanguage = 'en'
    reviewCountry = 'US'
  }

پس از ایجاد نظر تجاری، ممکن است چند دقیقه طول بکشد تا بازبینی منتشر شود.

مشاهده نظرات بازرگانان

برای مشاهده نظر تجاری، از accounts.merchantreviews.get استفاده کنید. این فقط خواندنی است. به merchantId شما و شناسه بازبینی تاجر به عنوان بخشی از قسمت نام نیاز دارد. متد دریافت منبع بررسی بازرگان مربوطه را برمی گرداند.

به عنوان مثال:

GET https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}

نظرات بازرگان را فهرست کنید

می‌توانید از روش merchantreviews.list برای مشاهده همه نظرات تجاری ایجاد شده استفاده کنید.

GET https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/*}/merchantReviews

نظرات بازرگان را حذف کنید

برای حذف نظر تجاری، از accounts.merchantreviews.delete استفاده کنید. مشابه روش دریافت، به فیلد نام بازبینی بازرگانی که در حین ایجاد برگردانده می شود، نیاز دارد.

به عنوان مثال:

DELETE https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}

وضعیت بررسی تاجر

منبع بررسی بازرگان دارای وضعیتی مشابه سایر APIها است که بخش جدایی ناپذیر منبع است و از ساختار موضوع و مقصد مشابهی پیروی می کند.