สร้าง Posts on Google

Google My Business API ช่วยให้คุณสามารถสร้างโพสต์ใน Google Search ภายในหมวดหมู่ต่างๆ เช่น ข่าวสาร กิจกรรม และข้อเสนอ

บทแนะนำนี้จะแสดงวิธีการทำสิ่งต่อไปนี้

ก่อนเริ่มต้น

คุณต้องลงทะเบียนแอปพลิเคชันก่อนที่จะใช้ 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 ของโพสต์ ลิงก์ไปยัง ระบบจะเพิ่ม 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"
}

ประเภทการทำงาน

โพสต์คำกระตุ้นให้ดำเนินการ (Call-To-Action) อาจมีประเภทการดำเนินการต่างๆ ซึ่งเป็นตัวกำหนดประเภท ของคำกระตุ้นให้ดำเนินการ (Call-To-Action) โพสต์

ประเภทคำกระตุ้นให้ดำเนินการที่รองรับมีดังนี้

ประเภทการทำงาน
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}