مدیریت به‌روزرسانی‌های Google

برای اینکه نمایه کسب‌وکارتان تا آنجا که ممکن است دقیق بماند، Google از اطلاعات منابعی مثل گزارش‌های کاربر و محتوای پروانه‌دار استفاده می‌کند. اگر اطلاعات ارائه‌شده توسط مالکان کسب‌وکار به‌عنوان اطلاعات نادرست گزارش شود، Google به مالکان فهرستگان اطلاع می‌دهد. سپس مالکان فهرستگان می‌توانند به‌روزرسانی‌ها را بپذیرند یا رد کنند.

به‌عنوان مالک فهرستگان، My Business Business Information API به شما امکان می‌دهد این به‌روزرسانی‌ها را مرور کنید تا مطمئن شوید اطلاعات کسب‌وکارتان دقیق است. این راهنما نحوه پذیرفتن یا رد کردن به‌روزرسانی‌ها را شرح می‌دهد.

برای مدیریت «به‌روزرسانی‌های Google»، مراحل زیر را تکمیل کنید:

1. پیدا کردن مکان‌های دارای به‌روزرسانی‌های معلقه
2. بازبینی فیلدهای به‌روزشده
3. پذیرفتن یا رد کردن به‌روزرسانی‌ها
4. بررسی نتایج

پیدا کردن مکان‌های دارای به‌روزرسانی‌های معلقه

قبل‌از اینکه بتوانید به‌روزرسانی‌ها را بپذیرید یا رد کنید، باید بدانید کدام مکان‌ها «به‌روزرسانی‌های Google» دردسترس دارند. بهترین راه برای دریافت «به‌روزرسانی‌های Google» برای مکان‌ها، مدیریت اعلان‌های هم‌زمان با Cloud Pub/Sub است. اگر GOOGLE_UPDATE اعلان در موضوع Pub/Sub خود دریافت کردید، تغییری برای بازبینی شما آماده است. فیلد locationName در اعلان نام منبع مکان را با «به‌روزرسانی‌های Google» ارائه می‌دهد.

یا می‌توانید تماس locations.get را ببینید و Metadata را برای وجود پرچم hasGoogleUpdated بررسی کنید. اگر "isGoogleUpdated": true، شناسه مکان منسوب به این مکان به‌روزرسانی‌هایی دارد.

درخواست

در زیر یک locations.get نمونه درخواست آورده شده است:

GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}

درخواست

در زیر نمونه‌ای از پاسخ locations.get آورده شده است:

{
  "name": "locations/{locationId}",
  "title": "Test Business",
  "phoneNumbers": {
      "primaryPhone": "02 9374 4000"
   },
  ...
  "metadata": {
    "hasGoogleUpdated": true,
    ...
  }
  ...
}

مرور فیلدهای به‌روزشده

برای بررسی فیلدهای خاصی که «به‌روزرسانی‌های Google» دارند، locations.getGoogleUpdated را فراخوانی کنید.

این روش دو ماسک مهم را در بدنه پاسخ برمی‌گرداند:

• diffMask: فیلدهایی را نشان می‌دهد که داده‌های ارائه‌شده (آنچه مشتریان در Google Maps و «جستجو» می‌بینند) با مقادیر ترجیحی محلی شما متفاوت است. این امر معمولاً به‌دلیل به‌روزرسانی‌های Google یا محتوای تولیدشده توسط کاربر است. برای حل‌وفصل این مغایرت، باید این فیلدها را بپذیرید یا رد کنید.
• pendingMask: نشان‌دهنده فیلدهایی است که قبلاً به‌روزرسانی برای آن‌ها ارسال کرده‌اید، اما به‌روزرسانی هنوز درحال پردازش است و هنوز به Google Maps و «جستجو» ارسال نشده است. لازم نیست در این فیلدها اقدامی انجام دهید.

درخواست

در زیر یک locations.getGoogleUpdated نمونه درخواست آورده شده است:

GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}:googleUpdated

پاسخ

در زیر نمونه‌ای از پاسخ locations.getGoogleUpdated آورده شده است. به‌روزرسانی دردسترسی را در فیلد phoneNumbers.primaryPhone نشان می‌دهد. مقدار موجود در این پاسخ، مقدار به‌روزرسانی پیشنهادی است:

{
  "location": {
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
  },
  "diffMask": "phoneNumbers.primaryPhone"
}

پذیرفتن یا رد کردن به‌روزرسانی‌ها

برای حل‌وفصل فیلدهای فهرست‌شده در diffMask، باید به‌روزرسانی‌ها را بااستفاده از درخواست locations.patch بپذیرید یا رد کنید:

• پذیرفتن به‌روزرسانی: مکان را بااستفاده از مقدار جدیدی که در پاسخ getGoogleUpdated برگردانده شده است وصله کنید. این کار سابقه محلی شما را به‌روز می‌کند تا با داده‌های ارائه‌شده مطابقت داشته باشد.
• رد کردن به‌روزرسانی: بااستفاده از مقدار ترجیحی اصلی‌تان، مکان را وصله کنید. این کار داده‌های ترجیحی شما را ازطریق خط لوله به‌روزرسانی مجدداً تأیید می‌کند و داده‌های ارائه‌شده را بازنویسی می‌کند.

در هر دو مورد، updateMask را طوری تنظیم کنید که فیلدهایی را که می‌خواهید حل‌وفصل کنید پوشش دهد.

پذیرفتن درخواست

در زیر نمونه‌ای از درخواست locations.patch آورده شده است:

PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
}

پاسخ

در زیر نمونه‌ای از پاسخ locations.patch آورده شده است:

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
}

رد کردن درخواست

در زیر یک locations.patch نمونه درخواست آورده شده است:

PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

پاسخ

در زیر نمونه‌ای از پاسخ locations.patch آورده شده است:

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

مرور نتایج

اگر مکانتان با موفقیت وصله شود، فیلد diffMask در locations.getGoogleUpdated پاسخ، مقادیر را به‌صورت "diffMask": "" نشان می‌دهد. همچنین، پرچم "hasGoogleUpdated" در Metadata مقدار را به‌صورت false نشان می‌دهد، یا هیچ مقداری وجود ندارد.

اگر مقادیر فیلد واضح نیست، با تیم پشتیبانی ما تماس بگیرید و درخواست و پاسخ getGoogleUpdated را ارائه دهید. درخواست باید شامل پاسخ قبل‌از تماس locations.patch، تماس وصله، و تماس getGoogleUpdated باشد.