API گوگل مای بیزینس (Google My Business) به شما این امکان را میدهد که در جستجوی گوگل، پستهایی را در دستهبندیهای مختلف، مانند اخبار، رویدادها و پیشنهادات، ایجاد کنید.
این آموزش به شما نشان میدهد که چگونه موارد زیر را انجام دهید:
- ایجاد پستهای رویداد
- پستهای دعوت به اقدام (Call to action) ایجاد کنید.
- پستهای پیشنهاد ایجاد کنید.
- ویرایش پستها .
- حذف پستها .
قبل از اینکه شروع کنی
قبل از استفاده از API گوگل مای بیزینس، باید برنامه خود را ثبت کنید و اعتبارنامههای OAuth 2.0 را دریافت کنید.
برای جزئیات بیشتر در مورد نحوه شروع به کار با API گوگل برای کسب و کار من، به تنظیمات اولیه مراجعه کنید.
پستهای رویداد
با یک پست، مشتریان خود را از رویداد بعدی در کسب و کارتان مطلع کنید. پست شما برای یک رویداد شامل تاریخ و زمان شروع و پایان است که به طور برجسته در پست نمایش داده میشود.
برای ارسال پست به حسابی که با یک کاربر مرتبط است، از API accounts.locations.localPosts استفاده کنید.
برای ایجاد پست برای یک کاربر احراز هویت شده، از موارد زیر استفاده کنید:
$ 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" }
پستهای فراخوان برای اقدام
پستهایی که دارای دکمه فراخوان عمل هستند، شامل یک دکمه نیز میشوند. متن روی دکمه فراخوان عمل توسط فیلد actionType پست تعیین میشود. لینکی به آدرس اینترنتی ارائه شده توسط کاربر به دکمه اضافه میشود.
برای ایجاد یک پست با دکمه فراخوان، از موارد زیر استفاده کنید:
$ 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" }
انواع اقدام
فراخوان عمل (call to action) پستها میتوانند انواع مختلفی از اقدامات داشته باشند که نوع فراخوان عمل پست را تعیین میکند.
انواع فراخوانی برای اقدام (call to action) پشتیبانی شده عبارتند از:
| انواع اقدام | |
|---|---|
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}