Google My Business API این امکان را در اختیار شما قرار می دهد که در جستجوی Google در چندین دسته، مانند اخبار، رویدادها و پیشنهادات، پست ایجاد کنید.
این آموزش به شما نشان می دهد که چگونه کارهای زیر را انجام دهید:
- ایجاد پست های رویداد
- ایجاد پست های فراخوان برای اقدام
- ایجاد پست های پیشنهادی
- ویرایش پست ها
- حذف پست ها
قبل از شروع
قبل از استفاده از Google My Business API، باید برنامه خود را ثبت کنید و اعتبارنامه OAuth 2.0 را دریافت کنید.
برای جزئیات در مورد نحوه شروع به کار با Google My Business API، به تنظیمات اولیه مراجعه کنید.
پست های رویداد
با یک پست به مشتریان خود در مورد رویداد بعدی در کسب و کار خود اطلاع دهید. پست شما برای یک رویداد شامل تاریخ ها و زمان های شروع و پایان است که به طور برجسته در پست نمایش داده می شود.
برای ایجاد یک پست در یک حساب مرتبط با یک کاربر، از accounts.locations.localPosts
API استفاده کنید.
برای ایجاد یک پست برای یک کاربر تایید شده، از موارد زیر استفاده کنید:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Come in for our spooky Halloween event!", "event": { "title": "Halloween Spook-tacular!", "schedule": { "startDate": { "year": 2017, "month": 10, "day": 31, }, "startTime": { "hours": 9, "minutes": 0, "seconds": 0, "nanos": 0, }, "endDate": { "year": 2017, "month": 10, "day": 31, }, "endTime": { "hours": 17, "minutes": 0, "seconds": 0, "nanos": 0, }, } }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-image.jpg", } ], "topicType": "EVENT" }
پست های فراخوان برای اقدام
پستهای دارای تماس برای اقدام شامل یک دکمه هستند. متن روی دکمه call to action توسط قسمت actionType
Post تعیین می شود. پیوندی به URL ارائه شده توسط کاربر به دکمه اضافه می شود.
برای ایجاد یک پست با دکمه تماس برای اقدام، از موارد زیر استفاده کنید:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Order your Thanksgiving turkeys now!!", "callToAction": { "actionType": "ORDER", "url": "http://google.com/order_turkeys_here", }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-turkey-photo.jpg", } ], "topicType": "OFFER" }
انواع اقدام
پستهای فراخوان میتوانند انواع کنشهای مختلفی داشته باشند که نوع پست دعوت به اقدام را تعیین میکنند.
موارد زیر انواع تماس برای اقدام پشتیبانی شده هستند:
انواع اقدام | |
---|---|
BOOK | پستی ایجاد می کند که از کاربر می خواهد یک قرار ملاقات، میز یا چیزی مشابه رزرو کند. |
ORDER | پستی ایجاد می کند که از کاربر می خواهد چیزی را سفارش دهد. |
SHOP | پستی ایجاد می کند که از کاربر می خواهد کاتالوگ محصول را مرور کند. |
LEARN_MORE | پستی ایجاد می کند که کاربر را وادار می کند جزئیات بیشتری را در یک وب سایت ببیند. |
SIGN_UP | پستی ایجاد می کند که از کاربر می خواهد ثبت نام کند، ثبت نام کند یا به چیزی بپیوندد. |
CALL | پستی ایجاد می کند که کاربر را وادار می کند تا با یک کسب و کار تماس بگیرد. |
پست های پیشنهادی
برای ایجاد پست پیشنهادی، از موارد زیر استفاده کنید:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Buy one Google jetpack, get a second one free!!", "offer": { "couponCode": “BOGO-JET-CODE”, "redeemOnlineUrl": “https://www.google.com/redeem”, "termsConditions": “Offer only valid if you can prove you are a time traveler” }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-jetpack-photo.jpg", } ], "topicType": "OFFER" }
ویرایش پست ها
پس از ایجاد یک پست، می توانید آن را با یک درخواست PATCH
ویرایش کنید.
برای ویرایش یک پست، از موارد زیر استفاده کنید:
$ PATCH https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary { "summary": "Order your Christmas turkeys now!!" }
حذف پست ها
پس از ایجاد یک پست، می توانید آن را با یک درخواست DELETE
حذف کنید.
برای حذف یک پست، از موارد زیر استفاده کنید:
$ DELETE https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}