ایجاد پست در گوگل

Google My Business API این امکان را در اختیار شما قرار می دهد که در جستجوی Google در چندین دسته، مانند اخبار، رویدادها و پیشنهادات، پست ایجاد کنید.

این آموزش به شما نشان می دهد که چگونه کارهای زیر را انجام دهید:

قبل از شروع

قبل از استفاده از Google My Business API، باید برنامه خود را ثبت کنید و اعتبارنامه OAuth 2.0 را دریافت کنید.

برای جزئیات در مورد نحوه شروع به کار با Google My Business API، به تنظیمات اولیه مراجعه کنید.

پست های رویداد

با یک پست به مشتریان خود در مورد رویداد بعدی در کسب و کار خود اطلاع دهید. پست شما برای یک رویداد شامل تاریخ ها و زمان های شروع و پایان است که به طور برجسته در پست نمایش داده می شود.

برای ایجاد یک پست در یک حساب مرتبط با یک کاربر، از accounts.locations.localPosts API استفاده کنید.

برای ایجاد یک پست برای یک کاربر تایید شده، از موارد زیر استفاده کنید:

HTTP
$ 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 ارائه شده توسط کاربر به دکمه اضافه می شود.

برای ایجاد یک پست با دکمه تماس برای اقدام، از موارد زیر استفاده کنید:

HTTP
$ 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 پستی ایجاد می کند که کاربر را وادار می کند تا با یک کسب و کار تماس بگیرد.

پست های پیشنهادی

برای ایجاد پست پیشنهادی، از موارد زیر استفاده کنید:

HTTP
$ 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 ویرایش کنید.

برای ویرایش یک پست، از موارد زیر استفاده کنید:

HTTP
$ PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary
{
  "summary": "Order your Christmas turkeys now!!"
}

حذف پست ها

پس از ایجاد یک پست، می توانید آن را با یک درخواست DELETE حذف کنید.

برای حذف یک پست، از موارد زیر استفاده کنید:

HTTP
$ DELETE
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}