สร้าง 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) อาจมีประเภทการดำเนินการที่แตกต่างกันซึ่งจะกำหนดประเภทของโพสต์คำกระตุ้นให้ดำเนินการ

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

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