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

پاسخ سوالات متداول در مورد API های پروفایل تجاری گوگل را بیابید.

API های GBP چیستند؟

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

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

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

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

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

آیا دسترسی به APIهای پوند انگلیس به کاربر اجازه می‌دهد تا از داده‌های پروفایل تجاری گوگل پرس‌وجو کند؟

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

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

شرکا باید با سیاست‌های نمایه کسب‌وکار گوگل و همچنین تمام سیاست‌ها و شرایط و ضوابط API مطابقت داشته باشند.

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

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

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

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

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

  • رابط برنامه‌نویسی کاربردی (API) گوگل برای کسب‌وکار من ۴.۹، که شامل فراخوانی‌های مهم API زیر است:
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • رابط برنامه‌نویسی کاربردی (API) مدیریت حساب کاربری کسب و کار من
  • API اقامتگاه کسب و کار من
  • API اقدامات مکان کسب و کار من
  • رابط برنامه‌نویسی کاربردی اعلان‌های کسب‌وکار من
  • API تأیید هویت کسب و کار من
  • API اطلاعات کسب و کار من
  • API عملکرد پروفایل کسب و کار

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

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

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

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

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

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

برای هرگونه سوال در مورد داده‌های موجود یا نحوه دسترسی به داده‌ها، این فرم را پر کنید.

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

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

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

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

  • راه‌اندازی OAuth: برای آشنایی با نحوه استفاده پلتفرم‌های شریک 3P از اعتبارنامه‌های تاجر برای ویرایش و دسترسی به داده‌های نمایه کسب‌وکار گوگل از طرف تاجر یا کسب‌وکار، به این راهنما مراجعه کنید .
  • دسترسی مالک یا مدیر: اگر یک شریک شخص ثالث توسط تاجر، که باید مالک اصلی پوند باشد، به عنوان مدیر نمایه کسب‌وکار گوگل اضافه شود، شریک شخص ثالث برای استفاده از APIهای پوند و ویرایش و دسترسی به داده‌های پوند نیازی به استفاده از اعتبارنامه‌های تاجر ندارد.

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

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

بله. شما می‌توانید برای بیش از ۱۰ پروفایل درخواست تأیید انبوه دهید . پس از تأیید، مکان‌های زنجیره‌ای منتشر شده را می‌توان با APIهای نمایه کسب‌وکار به همان روشی که سایر مکان‌ها مدیریت می‌شوند، با برخی استثنائات، مدیریت کرد. به عنوان مثال، با مدیران سایت به طور متفاوتی رفتار می‌شود و آنها می‌توانند خود را به مکان‌های حق امتیاز اضافه کنند.

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

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

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

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

آیا شرکای API پوند می‌توانند یک حساب آزمایشی برای محصول ایجاد کنند؟

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

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