تأیید صحت را مدیریت کنید

ارائه‌دهندگانی که مدیریت فهرست را مستقیماً در پلتفرم خود ارائه می‌دهند، می‌توانند کسب‌وکار یک تاجر را در سایت خود تأیید کنند. این امر نیاز به هدایت تاجر به رابط کاربری نمایه کسب‌وکار را از بین می‌برد.

دریافت وضعیت فعلی

کاربران می‌توانند برای بازیابی وضعیت فعلی یک مکان، تابع locations.getVoiceOfMerchantState را فراخوانی کنند. اگر مقدار بولی hasVoiceOfMerchant true باشد، آن مکان از قبل در وضعیت خوبی قرار دارد و نیازی به اقدام اضافی نیست. در غیر این صورت، اگر اقدام gain_voice_of_merchant در پاسخ شامل verify باشد، باید تأیید را تکمیل کنید. برای اطلاعات بیشتر، دستورالعمل‌های زیر را دنبال کنید.

گزینه‌های تأیید واکشی

ارائه‌دهندگان می‌توانند از متد locations.fetchVerificationOptions برای وادار کردن فروشندگان به انتخاب یک روش تماس ترجیحی از فهرست روش‌های تأیید موجود استفاده کنند.

برای دریافت گزینه‌های تأیید، از موارد زیر استفاده کنید:

اچ‌تی‌پی 
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

شروع فرآیند تأیید

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

اچ‌تی‌پی 
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
:verify

// Use only one of the below verification methods

// For postcard verification:
{
  "method": "ADDRESS",
  "languageCode": "en",
  "addressInput": {
    "mailerContactName": "Ann Droyd"
  }
}

// For phone verification:
{
  "method": "PHONE_CALL",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For SMS verification:
{
  "method": "SMS",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For email verification:
{
  "method": "EMAIL",
  "languageCode": "en",
  "emailInput": {
    "emailAddress": "ex@google.com"
  }
}

بازیابی تأییدیه‌های فعلی

فراخوانی locations.verifications.list تاریخچه درخواست‌های تأیید هویت را به همراه وضعیت آنها برای مکان مشخص شده در فراخوانی بازیابی می‌کند.

برای بازیابی تمام درخواست‌های تأیید، از موارد زیر استفاده کنید:

اچ‌تی‌پی 
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

تکمیل تأیید در حال بررسی

معمولاً برای تکمیل تأیید هویت یک کسب‌وکار، یک کد پین و متد locations.verifications.complete مورد نیاز است.

برای تکمیل تأیید در حال بررسی، از موارد زیر استفاده کنید:

اچ‌تی‌پی 
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}

بهترین شیوه‌ها برای تأیید GBP با استفاده از API

ایجاد موقعیت مکانی

با استفاده از API اطلاعات کسب و کار GBP، می‌توانید پلتفرم خود را برای ارائه قابلیت ایجاد مکان تعبیه کنید. وقتی از فروشندگان می‌خواهید مکان جدیدی اضافه کنند، حتماً این مراحل را دنبال کنید:

اطلاعات مکانی مانند نام کسب و کار، آدرس، دسته بندی را از فروشنده جمع آوری کنید.

  1. با نقطه پایانی googleLocations.search تماس بگیرید.
  2. داده‌های موقعیت مکانی، مانند نام کسب و کار، دسته بندی، آدرس، شماره تلفن و وب‌سایت را در درخواست API ارائه دهید.

روش دیگر، انجام جستجوی مکان منطبق بالقوه با دنبال کردن این مراحل است:

  1. تطابق‌های مکانی احتمالی را جستجو کنید.
  2. از فروشنده بخواهید مکان صحیح را انتخاب کند.
  3. اگر requestAdminRightsUrl در پاسخ مکان وجود دارد، به تاجر کمک کنید تا برای آن مکان در نمایه کسب‌وکار گوگل درخواست دسترسی و مالکیت کند.
  4. اگر requestAdminRightsUrl وجود ندارد، یک مکان جدید با شناسه مکان در پاسخ مکان ایجاد کنید.
  5. مکان جدید را تأیید کنید.

توجه: اگر از جستجوی اولیه خود هیچ تطابق مکانی ممکنی پیدا نکردید، از یک شناسه مکان خالی برای ایجاد یک مکان جدید استفاده کنید. سپس، آن مکان جدید را تأیید کنید.

تأیید موقعیت مکانی

برای شروع فرآیند تأیید با استفاده از API GBP، لطفاً این مراحل را دنبال کنید:

  1. برای فهرست کردن تمام مکان‌های یک حساب گوگل، متد accounts.locations.list را فراخوانی کنید.
  2. مکانی را برای تأیید انتخاب کنید.
  3. برای تأیید اینکه آیا آن مکان نیاز به تأیید دارد یا خیر، متد GetVoiceOfMerchant API را فراخوانی کنید.
  4. اگر پاسخ، تأیید را برگرداند، تابع fetchVerificationOptions را فراخوانی کنید تا لیستی از روش‌های موجود برای تأیید آن مکان را دریافت کنید.
  5. دوباره بررسی کنید که داده‌های verificationOption شامل آدرس، شماره تلفن و آدرس ایمیل صحیح باشد.
  6. پس از اینکه ربات بهترین گزینه‌ی تأیید موجود را انتخاب کرد، متد locations.verify را برای شروع تأیید مناسب فراخوانی کنید. برای تأیید اینکه شروع تأیید در حال انجام است، locations.verifications.list.
  7. متد locations.verification.complete را با پین فروشنده فراخوانی کنید.
  8. متد GetVoiceOfMerchant API را فراخوانی کنید. اگر HasVoiceOfMerchant = true ، شما با موفقیت مکان را تأیید کرده‌اید.

توجه: اگر تأیید AUTO برای مکان مورد نظر در دسترس باشد، فروشنده نیازی به انجام هیچ مرحله تأییدی ندارد.

برای اطلاعات بیشتر در مورد تأیید GBP، لطفاً به مقاله پشتیبانی مرکز راهنمایی ما مراجعه کنید.