My Business Business Information API

My Business Business Information API میانایی برای مدیریت اطلاعات کسب‌وکار در Google ارائه می‌دهد. توجه: اگر پس‌از فعال کردن میانای برنامه‌سازی کاربردی، سهمیه شما ۰ است، لطفاً در https://developers.google.com/my-business/content/prereqs#request-access درخواست دسترسی به میانای برنامه‌سازی کاربردی «نمایه کسب‌وکار Google» را ارسال کنید.

سرویس: mybusinessbusinessinformation.googleapis.com

برای فراخوانی این سرویس، توصیه می‌کنیم از کتابخانه‌های کارخواه ارائه‌شده توسط Google استفاده کنید. اگر برنامه شما برای فراخوانی این سرویس باید از کتابخانه‌های خودتان استفاده کند، هنگام درخواست‌های API از اطلاعات زیر استفاده کنید.

سند اکتشاف

سند اکتشاف مشخصاتی ماشین‌خوانا برای توصیف و مصرف میاناهای برنامه‌سازی کاربردی REST است. از آن برای ساختن کتابخانه‌های کارخواه، افزایه‌های IDE، و ابزارهای دیگری که با Google API تعامل دارند استفاده می‌شود. یک سرویس ممکن است چندین سند اکتشاف ارائه دهد. این سرویس اسناد اکتشاف زیر را ارائه می‌دهد:

نقطه پایان سرویس

نقطه پایان سرویس نشانی وب پایه‌ای است که نشانی شبکه سرویس میانای برنامه‌سازی کاربردی را مشخص می‌کند. یک سرویس ممکن است چندین نقطه پایانی سرویس داشته باشد. این سرویس نقطه پایانی سرویس زیر را دارد و همه URIهای زیر مربوط به این نقطه پایانی سرویس هستند:

  • https://mybusinessbusinessinformation.googleapis.com

منبع REST: v1.accounts.locations

روش‌ها
create POST /v1/{parent=accounts/*}/locations
«مکان» جدیدی ایجاد می‌کند که کاربر واردشده به سیستم مالک آن خواهد بود.
list GET /v1/{parent=accounts/*}/locations
مکان‌های حساب مشخص‌شده را فهرست می‌کند.

منبع REST:‏ v1.attributes

روش‌ها
list GET /v1/attributes
فهرست مشخصه‌هایی را که برای مکان با دسته اصلی و کشور ارائه‌شده دردسترس است برمی‌گرداند.

منبع REST: v1.categories

روش‌ها
batchGet GET /v1/categories:batchGet
فهرستی از دسته‌های کسب‌وکار را برای زبان ارائه‌شده و شناسه‌های GConcept برمی‌گرداند.
list GET /v1/categories
فهرستی از دسته‌های کسب‌وکار را برمی‌گرداند.

منبع REST:‏ v1.chains

روش‌ها
get GET /v1/{name=chains/*}
زنجیره مشخص‌شده را دریافت می‌کند.
search GET /v1/chains:search
زنجیره را براساس نام زنجیره جستجو می‌کند.

منبع REST: v1.googleLocations

روش‌ها
search POST /v1/googleLocations:search
همه مکان‌های احتمالی را که با درخواست مشخص‌شده مطابقت دارند جستجو کنید.

منبع REST: v1.locations

روش‌ها
delete DELETE /v1/{name=locations/*}
مکانی را حذف می‌کند.
get GET /v1/{name=locations/*}
مکان مشخص‌شده را همان‌طور که آخرین‌بار توسط فروشنده تنظیم شده است برمی‌گرداند.
getAttributes GET /v1/{name=locations/*/attributes}
مشخصه‌های مکان را همان‌طور که آخرین‌بار توسط فروشنده تنظیم شده است بازیابی می‌کند.
getGoogleUpdated GET /v1/{name=locations/*}:getGoogleUpdated
مکان مشخص‌شده را همان‌طور که به‌طور زنده در Google Maps و «جستجو» نشان داده می‌شود برمی‌گرداند.
patch PATCH /v1/{location.name=locations/*}
مکان مشخص‌شده را به‌روز می‌کند.
updateAttributes PATCH /v1/{attributes.name=locations/*/attributes}
به‌روزرسانی مشخصه‌های مکان موردنظر.

منبع REST: v1.locations.attributes

روش‌ها
getGoogleUpdated GET /v1/{name=locations/*/attributes}:getGoogleUpdated
مشخصه‌های مکان را همان‌طور که در Google Maps و «جستجو» به‌صورت زنده نشان داده می‌شود بازیابی می‌کند.

منبع REST:‏ v1alpha.accounts.locations

روش‌ها
create POST /v1alpha/{parent=accounts/*}/locations
«مکان» جدیدی ایجاد می‌کند که کاربر واردشده به سیستم مالک آن خواهد بود.
list GET /v1alpha/{parent=accounts/*}/locations
مکان‌های حساب مشخص‌شده را فهرست می‌کند.

منبع REST:‏ v1alpha.attributes

روش‌ها
list GET /v1alpha/attributes
فهرست مشخصه‌هایی را که برای مکان با دسته اصلی و کشور ارائه‌شده دردسترس است برمی‌گرداند.

منبع REST:‏ v1alpha.categories

روش‌ها
batchGet GET /v1alpha/categories:batchGet
فهرستی از دسته‌های کسب‌وکار را برای زبان ارائه‌شده و شناسه‌های GConcept برمی‌گرداند.
list GET /v1alpha/categories
فهرستی از دسته‌های کسب‌وکار را برمی‌گرداند.

منبع REST:‏ v1alpha.chains

روش‌ها
get GET /v1alpha/{name=chains/*}
زنجیره مشخص‌شده را دریافت می‌کند.
search GET /v1alpha/chains:search
زنجیره را براساس نام زنجیره جستجو می‌کند.

منبع REST:‏ v1alpha.googleLocations

روش‌ها
search POST /v1alpha/googleLocations:search
همه مکان‌های احتمالی را که با درخواست مشخص‌شده مطابقت دارند جستجو کنید.

منبع REST:‏ v1alpha.locations

روش‌ها
delete DELETE /v1alpha/{name=locations/*}
مکانی را حذف می‌کند.
get GET /v1alpha/{name=locations/*}
مکان مشخص‌شده را همان‌طور که آخرین‌بار توسط فروشنده تنظیم شده است برمی‌گرداند.
getAttributes GET /v1alpha/{name=locations/*/attributes}
مشخصه‌های مکان را همان‌طور که آخرین‌بار توسط فروشنده تنظیم شده است بازیابی می‌کند.
getExtended GET /v1alpha/{name=locations/*}:getExtended
مکان مشخص‌شده را با فراداده گسترده برمی‌گرداند.
getGoogleUpdated GET /v1alpha/{name=locations/*}:getGoogleUpdated
مکان مشخص‌شده را همان‌طور که به‌طور زنده در Google Maps و «جستجو» نشان داده می‌شود برمی‌گرداند.
patch PATCH /v1alpha/{location.name=locations/*}
مکان مشخص‌شده را به‌روز می‌کند.
updateAttributes PATCH /v1alpha/{attributes.name=locations/*/attributes}
به‌روزرسانی مشخصه‌های مکان موردنظر.

منبع REST:‏ v1alpha.locations.attributes

روش‌ها
getExtended GET /v1alpha/{name=locations/*/attributes}:getExtended
مشخصه‌های تعیین‌شده را با فراداده گسترش‌یافته برمی‌گرداند.
getGoogleUpdated GET /v1alpha/{name=locations/*/attributes}:getGoogleUpdated
مشخصه‌های مکان را همان‌طور که در Google Maps و «جستجو» به‌صورت زنده نشان داده می‌شود بازیابی می‌کند.