مکان‌های داخلی از نمایه کسب‌وکار

نمایه کسب‌وکار ابزاری رایگان و با کاربرد آسان برای کسب‌وکارها و سازمان‌ها برای مدیریت حضور آنلاین خود در سراسر Google، از جمله جستجو و نقشه‌ها است.

Google Business Profile API یک رابط برای مدیریت اطلاعات مکان کسب و کار در Google ارائه می دهد. یک کسب و کار می تواند از طریق رضایت OAuth به کسب و کار دیگری اجازه دهد تا نمایه خود را از طرف او مدیریت کند.

کسب‌وکارهای مدیریت‌شده در «نمایه کسب‌وکار» قبلاً از طریق فرآیند تأیید «نمایه کسب‌وکار» تأیید شده‌اند. می‌توانید جریان رضایت OAuth نمایه کسب‌وکار را برای حضور در این کسب‌وکارها به «پیام‌های تجاری» گسترش دهید و آنها را برای راه‌اندازی در «پیام‌های تجاری» به‌طور خودکار تأیید کنید.

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

پیش نیازها

شما باید شریک موجود در نمایه کسب و کار با دسترسی به APIهای نمایه کسب و کار Google باشید. اگر نیستید، پیش نیازهای نمایه کسب و کار را برای درخواست دسترسی دنبال کنید.

هنگامی که به شما اجازه دسترسی به Google Business Profile API داده شد، قبل از ادامه راه‌اندازی اولیه و راهنمای راه‌اندازی OAuth را دنبال کنید.

پیام‌های تجاری را برای یک مکان تأیید شده نمایه کسب‌وکار فعال کنید

نمودار زیر نشان می‌دهد که چگونه وب سرویس شما می‌تواند از تأیید موقعیت مکانی نمایه تجاری یک نام تجاری برای یک نماینده پیام‌های تجاری استفاده کند. برای دستورالعمل های دقیق به زیر مراجعه کنید.

1. در جریان رضایت OAuth موجود، جایی که مالک حساب نمایه کسب‌وکار به شما اجازه می‌دهد از طرف او با APIهای نمایه کسب‌وکار Google تماس بگیرید، دامنه‌های API را به‌روزرسانی کنید تا شامل شود.

   • https://www.googleapis.com/auth/business.manage
   • https://www.googleapis.com/auth/businesscommunications

   هر دو حوزه برای تأیید موفقیت آمیز خودکار نمایندگی و مکان های تجاری مورد نیاز هستند.

2. یک نماینده با یک displayName ایجاد کنید که با نام حداقل یکی از فهرست‌های نمایه کسب‌وکار Google متعلق به اعتبارنامه‌های OAuth که در مرحله قبل به دست آورده‌اید، مطابقت داشته باشد. مکان‌ها را با Google Business Profile API جستجو کنید تا نام کسب‌وکارها را بیابید.

   برای تطبیق نام،

   • پوشش نویسه حساس نیست.
   • نام کامل نماینده باید دقیقاً با اولین کلمه یا کلمات موجود در نام مکان نمایه کسب و کار مطابقت داشته باشد. برای مثال، نماینده‌ای به نام «GBP Bakery» با «Gbp Bakery Mountain View»، «Gbp Bakery» و «gbp Bakery Sunnyvale» مطابقت دارد، اما با «Bakery San Francisco» مطابقت ندارد.

3. برای هر مکان در نمایه کسب و کار، یک مکان با همان placeId کنید. وقتی یک مکان از API نمایه کسب و کار Google بازیابی می شود، placeId برای مکان نمایه کسب و کار در شی LocationKey قرار می گیرد.

4. با عاملی که ایجاد کردید و نشانه OAuth به دست آمده، تأیید نماینده را درخواست کنید.

   توجه: شما باید از نشانه OAuth با دامنه دوگانه به دست آمده استفاده کنید، نه از کلید حساب سرویس پروژه خود.

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

   اگر این کار را به درستی انجام دادید، خروجی درخواست verificationState باید فوراً یک VERIFICATION_STATE_VERIFIED را برگرداند. اگر verificationState مقدار متفاوتی را برمی گرداند، احتمالاً هنگام درخواست از کد OAuth درست استفاده نکرده اید یا اینکه عامل با مکان نمایه کسب و کار مطابقت نداشته باشد.

5. با استفاده از همان کد OAuth، تأیید موقعیت مکانی را برای همه مکان‌های متعلق به کسب‌وکار در نمایه کسب‌وکار درخواست کنید.

   همانند راستی‌آزمایی نماینده، اگر این کار را به درستی انجام داده باشید، خروجی درخواست تأیید باید فوراً وضعیت verificationState VERIFICATION_STATE_VERIFIED را برگرداند. اگر verificationState مقدار متفاوتی را برمی گرداند، احتمالاً هنگام ارسال درخواست از کد OAuth صحیح استفاده نکرده اید یا مکان نمایه کسب و کار یک کسب و کار ادعا شده و تأیید شده نیست.

6. عامل را با نقطه ورود LOCATION راه اندازی کنید.

7. با راه‌اندازی مکان‌هایی که می‌خواهید از طریق جستجو و Maps در دسترس باشند، پیام‌رسانی را برای مکان‌های خاص فعال کنید. پس از شروع فرآیند راه اندازی، پیام رسانی برای هر مکان راه اندازی شده در عرض چند ساعت در دسترس کاربران قرار می گیرد.

هنگامی که این مراحل را دنبال کردید، همه پیام‌های مصرف‌کننده در وب‌قلاب پیام‌های تجاری ثبت‌شده شما پست می‌شوند، و باید پاسخ‌ها را با Business Messages API برای مصرف‌کنندگان ارسال کنید.