Google My Business API ช่วยให้คุณสร้างโพสต์ใน Google Search ได้ในหลายหมวดหมู่ เช่น ข่าวสาร กิจกรรม และข้อเสนอ
บทแนะนำนี้จะแสดงวิธีทำสิ่งต่อไปนี้
- สร้างโพสต์กิจกรรม
- สร้างโพสต์คำกระตุ้นให้ดำเนินการ (Call-To-Action)
- สร้างโพสต์ข้อเสนอ
- แก้ไขโพสต์
- ลบโพสต์
ก่อนเริ่มต้น
ก่อนใช้ 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)
โพสต์ที่มีคำกระตุ้นให้ดำเนินการ (Call-To-Action) จะมีปุ่ม ข้อความบนปุ่มคำกระตุ้นให้ดำเนินการ (Call-To-Action) จะกำหนดโดยช่อง actionType ของโพสต์ ระบบจะเพิ่มลิงก์ไปยัง URL ที่ผู้ใช้ระบุไว้ในปุ่ม
หากต้องการสร้างโพสต์ที่มีปุ่มคำกระตุ้นให้ดำเนินการ (Call-To-Action) ให้ใช้โค้ดต่อไปนี้
$ 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)
ประเภทคำกระตุ้นให้ดำเนินการ (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}