سوالات متداول

API های GBP چیست؟

APIهای Business Profile رابط‌های برنامه‌نویسی هستند که به توسعه‌دهندگان اجازه می‌دهند برنامه‌هایی را برای مدیریت حساب نمایه تجاری و داده‌های مکان خود بنویسند. APIها به تاجران یا نمایندگان آنها اجازه می‌دهند تا نحوه ارائه داده‌هایشان را در Google مدیریت کنند و کنترل کنند که چه کسی داده‌های آنها را مدیریت می‌کند. داده‌های ایجاد شده توسط کاربر، مانند عکس‌ها، پست‌ها و نظرات را نیز می‌توان از طریق APIها مدیریت کرد.

APIهای Business Profile تقریباً همان ویژگی‌های رابط کاربری Business Profile را با برخی از ویژگی‌های اضافی مخصوص APIها ارائه می‌دهند. کاربران APIها می‌توانند انتظار داشته باشند که به‌روزرسانی‌های Google درست مانند کاربران رابط کاربری رخ دهد.

چه کسی می تواند به API های GBP دسترسی داشته باشد؟

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

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

آیا دسترسی به APIهای GBP به کاربر اجازه می‌دهد از داده‌های نمایه کسب‌وکار Google پرس و جو کند؟

خیر. حتی اگر به APIهای GBP دسترسی داشته باشید، نمی‌توانید از داده‌های نمایه کسب‌وکار Google پرس‌وجو کنید مگر اینکه به آن نمایه کسب‌وکار Google خاص دسترسی داشته باشید.

سیاست های مربوطه برای کاربران GBP API چیست؟

شرکا باید با خط‌مشی‌های نمایه کسب‌وکار Google همراه با همه خط‌مشی‌ها و شرایط و ضوابط API مطابقت داشته باشند.

چگونه کاربران به GBP API دسترسی پیدا می کنند؟

برای ایجاد موفقیت آمیز اولین برنامه مشتری خود، باید پیش نیازهای زیر را تکمیل کنید:

  1. یک حساب Google دریافت کنید .
  2. نمایه کسب و کار را امتحان کنید .
  3. یک پروژه در Google API Console ایجاد کنید .
  4. درخواست دسترسی به API : درخواست‌ها ظرف 14 روز بررسی می‌شوند.

چگونه کاربران به یک API خاص در GBP API دسترسی پیدا می کنند؟

هشت API مرتبط با نمایه کسب و کار وجود دارد که باید در Google API Console فعال شوند:

  • Google My Business API 4.9، که شامل فراخوان‌های API ویژگی مهم زیر است:
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • API مدیریت حساب کسب و کار من
  • My Business Lodging API
  • My Business Place Actions API
  • My Business Notifications API
  • My Business Verifications API
  • API اطلاعات کسب و کار من
  • API پرسش و پاسخ کسب و کار من
  • API عملکرد نمایه کسب و کار

اگر درخواست کاربر برای درخواست دسترسی تأیید شود، یک سهمیه پیش فرض استاندارد برای هر هشت API به آنها اعطا می شود.

دسترسی به GBP API چگونه کار می کند؟

دسترسی GBP API در سطح پروژه Google Cloud اعطا می شود. اگر کاربر A برای دسترسی به API نمایه Google Business برای پروژه شماره - 12345678 درخواست داده باشد، به پروژه شماره - 12345678 اعطا می شود. بنابراین هر کاربری از جمله کاربر A با دسترسی به پروژه Google Cloud می تواند با Google Business تماس بگیرد. API های پروفایل شرکا باید دسترسی به پروژه Google Cloud را بر اساس نیاز به دسترسی برای جلوگیری از سوء استفاده کنترل کنند.

آیا خلاصه ای از API ها و قابلیت های نمونه دارید؟

برای اطلاع از API های مختلف و قابلیت های آنها به جدول زیر مراجعه کنید.

API مستندات مرجع قابلیت های نمونه
API مدیریت حساب مستندات
  • مدیریت دسترسی به یک مکان
  • یک حساب کاربری با نام و نوع مشخص شده در زیر والد داده شده ایجاد می کند.
  • همه اکانت ها را برای کاربر احراز هویت شده فهرست می کند.
  • دعوت‌نامه‌های معلق را برای حساب مشخص‌شده فهرست می‌کند.
  • مکان را از حسابی که کاربر دارد به حساب دیگری منتقل می کند.
  • مدیر را برای مکان مشخص شده به روز می کند.
API اطلاعات کسب و کار مستندات
  • Business Information API امکان مدیریت چرخه عمر نمایه و افزودن یا مدیریت اطلاعات کسب و کار در GBP را فراهم می کند.
  • به تاجران اجازه می‌دهد نمایه‌های کسب‌وکار Google را دریافت، ایجاد، به‌روزرسانی یا حذف کنند.
  • به بازرگانان اجازه می‌دهد تا ویژگی‌های نمایه را دریافت یا به‌روزرسانی کنند.
  • به بازرگانان اجازه می‌دهد زنجیره‌ها، دسته‌های نمایه را دریافت یا جستجو کنند.
Lodging API مستندات
  • به مدیریت داده‌های محل اقامت، به‌عنوان مثال، امکانات رفاهی، و خط‌مشی‌های کسب‌وکارها در Google اجازه می‌دهد. API مخصوص مشاغلی است که خدمات اقامتی مانند هتل ها را ارائه می دهند. Lodging API به توسعه دهندگان اجازه می دهد تا ویژگی های اقامت در نمایه کسب و کار Google را به روز کنند.
Place Actions API مستندات
  • به مدیریت پیوندهای اقدام مکان در مشاغل اجازه می دهد.
  • کاربران را به انجام اقداماتی مانند رزرو قرار، رزرو میز و سفارش تحویل غذا هدایت کنید.
Notifications API مستندات
  • مدیریت تنظیمات اعلان را برای حساب های مشخص شده فعال می کند.
Verifications API مستندات
  • فرآیند تأیید یک مکان را شروع می کند.
  • همه گزینه های تأیید واجد شرایط را برای یک مکان به زبان خاصی گزارش می دهد.
API پرسش و پاسخ مستندات
  • به مدیریت سؤالات و پاسخ های یک مکان اجازه می دهد.
API عملکرد نمایه کسب و کار مستندات
  • به بازرگانان اجازه می‌دهد اطلاعات آماری عملکرد درباره فهرست کسب‌وکارشان در Google واکشی کنند.
  • اطلاعات آماری شامل نمایش‌های تجاری، درخواست‌های جهت، کلیک‌های تماس، کلیک‌های وب‌سایت، رزرو، سفارش‌های غذا، تعاملات منو و موارد دیگر است.
Media API مستندات
  • به توسعه دهندگان API اجازه می دهد عکس ها و ویدیوها را برای نمایه کسب و کار آپلود کنند.
نظرات API مستندات
  • به بازرگانان اجازه می‌دهد نظرات را دریافت کنند و به نظرات در نمایه کسب‌وکار پاسخ دهند.
Local Posts API مستندات
  • به تاجران اجازه می‌دهد پست‌های محلی را دریافت، ایجاد یا به‌روزرسانی کنند.
FoodMenus API مستندات
  • به بازرگانان اجازه می‌دهد منوهای غذا را برای نمایه کسب‌وکار دریافت، ایجاد یا به‌روزرسانی کنند.

اگر هنوز درباره داده‌های در دسترس شما و/یا نحوه دسترسی به داده‌ها سؤالی دارید، از فرم‌های زیر برای ثبت درخواست استفاده کنید:

چگونه شرکا می توانند ساختار حساب خود را برای استفاده از GBP API تنظیم کنند؟

اگر شریک شخص ثالثی هستید که مدیریت فهرست را برای مشاغل انجام می دهد:

چگونه کسب و کارها به شریک GBP API مجوز می دهند تا فهرست کسب و کار خود را مدیریت کند؟

کسب و کارها به دو روش به شریک 3P دسترسی می دهند:

  • راه‌اندازی OAuth: برای درک نحوه استفاده پلتفرم‌های شریک 3P از اعتبار تجاری برای ویرایش و دسترسی به داده‌های نمایه کسب‌وکار Google از طرف تاجر یا کسب‌وکار ، به این راهنما مراجعه کنید .

  • دسترسی مالک یا مدیر: اگر یک شریک 3P به عنوان مدیر نمایه کسب و کار Google توسط تاجر اضافه شود که باید مالک اصلی GBP باشد، شریک 3P نیازی به استفاده از اعتبار تجاری برای استفاده از APIهای GBP برای ویرایش و دسترسی ندارد. داده GBP

    توجه: ما قویاً توصیه می کنیم که شرکای 3P خود را به عنوان مالک GBP اضافه نکنند، بلکه فقط خود را به عنوان مدیر اضافه کنند.

اگر کسب‌وکاری بیش از 10 مکان دارد، آیا راهی برای تأیید انبوه وجود دارد؟

بله. می‌توانید برای بیش از 10 نمایه درخواست تأیید انبوه کنید . پس از تأیید، مکان‌های زنجیره منتشر شده را می‌توان با APIهای نمایه کسب‌وکار به همان شیوه‌ای که مکان‌های دیگر مدیریت می‌شوند، به استثنای برخی موارد، مدیریت کرد. به عنوان مثال، با مدیران سایت متفاوت رفتار می شود، و آنها می توانند خود را به مکان های فرنچایز اضافه کنند.

محدودیت های سهمیه ای برای API های مختلف چیست؟

محدودیت‌های سهمیه استاندارد در محدودیت‌های استفاده فهرست شده‌اند. اگر به محدودیت های بالاتر نیاز دارید، می توانید یک درخواست سهمیه استاندارد ارسال کنید.

چقدر می توانم سهمیه درخواست کنم؟

سهمیه یک منبع محدود است. تیم پشتیبانی GBP API واجد شرایط بودن درخواست افزایش سهمیه شما را با تأیید استفاده از سهمیه گذشته شما تعیین می کند. اگر میانگین استفاده از سهمیه شما کمتر از 70 درصد از محدودیت‌های سهمیه فعلی شما باشد، ممکن است از افزایش بیشتر محدودیت‌های سهمیه خودداری کنید.

آیا شرکای GBP API می توانند یک حساب آزمایشی برای prod ایجاد کنند؟

نه. متأسفانه، هیچ راه مستقیمی برای ایجاد یک فهرست GBP جعلی در محصول از طریق GBP UI یا API وجود ندارد و در مقابل آن آزمایش می شود.

اکثر فهرست‌های جعلی که ایجاد می‌شوند توسط نظارت ما پرچم‌گذاری شده و به حالت تعلیق در می‌آیند. توصیه این است که یا از فهرست مشتری استفاده کنید و بعد از ساعت کاری با آن کار کنید (به شرطی که هیچ اطلاعات اولیه فهرست را تغییر ندهید، مانند نام، آدرس، دسته بندی) یا فهرستی برای دفتر مرکزی شرکت خود ایجاد کنید. اگر می‌خواهید یک پاسخ API را برای تأیید فهرست یا هر اقدام دیگری که به فهرست تولیدی نیاز دارد آزمایش کنید، می‌توانید از پاسخ‌های API ساختگی استفاده کنید.