GoogleLocations

GoogleLocations API به شما امکان می‌دهد از قبل ببینید آیا یک مکان در نمایه کسب‌وکار ادعا شده است یا خیر. به این ترتیب، اگر موقعیت مکانی ادعا شده باشد، می توانید بلافاصله درخواست دسترسی به مکان را بدهید. همچنین، اگر حساب‌های تأیید شده انبوه را مدیریت می‌کنید، می‌توانید از قبل موارد مشابه را با دقت بیشتری انتخاب کنید و از ایجاد مکان‌های تکراری اجتناب کنید.

نقطه پایانی API نشانی اینترنتی را برمی‌گرداند که نشان می‌دهد آیا مکانی قبلاً ادعا شده است یا خیر. اگر ادعا شده است، همان URL به شما امکان می دهد فرآیند درخواست دسترسی را شروع کنید.

تصویر زیر نمای کلی از فرآیند به دست آوردن مالکیت یک مکان را ارائه می دهد.

شکل 1. نمودار Swimlane مالکیت مکان نمایه کسب و کار

مراحل زیر به شما امکان می دهد از GoogleLocations API استفاده کنید:

  1. داده های مکان را از تاجر جمع آوری کنید.

  2. با نقطه پایانی googleLocations.search تماس بگیرید. داده های مکان را در متن تماس ارائه دهید. همچنین، می‌توانید آن را در یک رشته پرس و جو ارائه کنید، مشابه آنچه کاربر در جستجو یا Maps وارد می‌کند. به عنوان مثال، "Starbucks 5th ave NYC."

    API فهرستی از مکان‌ها و اطلاعات بالقوه مطابق با هر مکان، مانند locationName و آدرس را برمی‌گرداند.

  3. مکانی را انتخاب کنید که با موقعیت مکانی شما مطابقت دارد. اگر هیچ منطبقی وجود ندارد، با accounts.locations.create تماس بگیرید و به مرحله 5 بروید.

  4. بر اساس وضعیت requestAdminRightsUrl در پاسخ، اقدامات زیر را انجام دهید:

    1. اگر requestAdminRightsUrl وجود داشته باشد، کاربر دیگری مالکیت فهرست را دارد. تاجر را به URL هدایت کنید تا درخواست دسترسی و مالکیت مکان موجود در نمایه کسب و کار را شروع کند.
    2. اگر requestAdminRightsUrl وجود ندارد، با accounts.locations.create تماس بگیرید و فهرست جدیدی ایجاد کنید که بعداً تأیید می شود.
  5. اگر فهرست‌های جدیدی را به عنوان بخشی از این فرآیند ایجاد کرده‌اید، می‌توانید از APIهای تأیید برای شروع تأیید فهرست‌ها استفاده کنید. برای اطلاعات بیشتر، به مدیریت تأیید صحت مراجعه کنید.