Google Updates را مدیریت کنید

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

به عنوان مالک فهرست، رابط برنامه‌نویسی کاربردی اطلاعات کسب و کار من به شما امکان می‌دهد این به‌روزرسانی‌ها را بررسی کنید تا از صحت اطلاعات کسب و کارتان مطمئن شوید. این راهنما نحوه پذیرش یا رد به‌روزرسانی‌ها را شرح می‌دهد.

برای مدیریت به‌روزرسانی‌های گوگل خود، مراحل زیر را انجام دهید:

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

مکان‌هایی را پیدا کنید که به‌روزرسانی‌های در انتظار دارند

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

به عنوان یک روش جایگزین، می‌توانید فراخوانی 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 Updates) دارند، از locations.getGoogleUpdated استفاده کنید.

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

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

درخواست

مثال زیر یک درخواست 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 ، فراخوانی patch و فراخوانی getGoogleUpdated .