เริ่มใช้งานสถานที่ตั้งจาก Business Profile

Business Profile เป็นเครื่องมือฟรีที่ใช้งานง่ายสำหรับให้ธุรกิจและองค์กรจัดการตัวตนในโลกออนไลน์ทั่วทั้ง Google รวมถึง Search และ Maps

Google Business Profile API มีอินเทอร์เฟซสำหรับจัดการข้อมูลสถานที่ตั้งธุรกิจบน Google ธุรกิจหนึ่งๆ สามารถให้สิทธิ์เข้าถึงผ่านความยินยอม OAuth แก่ธุรกิจอื่นเพื่อจัดการโปรไฟล์ในนามของตนได้

ธุรกิจที่มีการจัดการใน Business Profile ได้รับการยืนยันแล้วผ่านกระบวนการยืนยัน Business Profile คุณสามารถขยายขั้นตอนการขอความยินยอม OAuth ของ Business Profile เพื่อเริ่มต้นใช้งาน Business Messages ของธุรกิจเหล่านี้และยืนยันโดยอัตโนมัติเพื่อเปิดตัวใน Business Messages

วิธีนี้เป็นวิธีที่ปรับขนาดได้เร็วขึ้นและเปิดใช้ Business Messages ได้เร็วขึ้น และเป็นขั้นตอนที่แนะนําสำหรับการเปิดใช้การรับส่งข้อความสําหรับสถานที่ตั้งของ Business Profile

ข้อกำหนดเบื้องต้น

คุณต้องเป็นพาร์ทเนอร์ Business Profile ที่มีอยู่ซึ่งมีสิทธิ์เข้าถึง Google Business Profile API หากไม่ใช่ ให้ทำตามข้อกําหนดเบื้องต้นของ Business Profile เพื่อสมัครรับสิทธิ์เข้าถึง

เมื่อได้รับสิทธิ์เข้าถึง Google Business Profile API แล้ว ให้ทําตามคำแนะนำการตั้งค่าพื้นฐานและการตั้งค่า OAuth ก่อนดำเนินการต่อ

เปิดใช้ Business Messages สําหรับสถานที่ตั้ง Business Profile ที่ยืนยันแล้ว

แผนภาพต่อไปนี้แสดงวิธีที่บริการเว็บของคุณใช้ประโยชน์จากการยืนยันสถานที่ตั้งของ Business Profile ของแบรนด์สําหรับตัวแทน Business Messages ดูวิธีการโดยละเอียดที่ด้านล่าง

1. ในขั้นตอนการขอความยินยอม OAuth ที่มีอยู่ซึ่งเจ้าของบัญชี Business Profile ให้สิทธิ์คุณในการเรียกใช้ Google Business Profile API ในนามของตน ให้อัปเดตขอบเขต API ให้รวม

   • https://www.googleapis.com/auth/business.manage
   • https://www.googleapis.com/auth/businesscommunications

   คุณต้องใช้ทั้ง 2 ขอบเขตเพื่อยืนยันตัวแทนและสถานที่ตั้งธุรกิจโดยอัตโนมัติให้เสร็จสมบูรณ์

2. สร้างตัวแทนที่มี displayName ซึ่งตรงกับชื่อของข้อมูล Google Business Profile อย่างน้อย 1 รายการที่เป็นของข้อมูลเข้าสู่ระบบ OAuth ที่คุณได้รับในขั้นตอนก่อนหน้า ค้นหาสถานที่ด้วย Google Business Profile API เพื่อทำนายชื่อธุรกิจ

   สำหรับการจับคู่ชื่อ

   • ระบบจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
   • ชื่อเต็มของตัวแทนต้องตรงกับคำแรกในชื่อสถานที่ตั้งของ Business Profile ทุกประการ เช่น ตัวแทนชื่อ "GBP Bakery" จะตรงกับ "Gbp Bakery Mountain View", "Gbp Bakery" และ "gbp bakery sunnyvale" แต่ไม่ตรงกับ "Bakery San Francisco"

3. สําหรับสถานที่ตั้งแต่ละแห่งใน Business Profile ให้สร้างสถานที่ตั้งที่มี placeId เดียวกัน placeId สำหรับสถานที่ตั้งของ Business Profile จะอยู่ในออบเจ็กต์ LocationKey เมื่อดึงข้อมูลสถานที่ตั้งจาก Google Business Profile API

4. ขอการยืนยันตัวแทนด้วยตัวแทนที่คุณสร้างและโทเค็น OAuth ที่ได้รับ

   หมายเหตุ: คุณต้องใช้โทเค็น OAuth แบบ 2 ขอบเขตที่ได้รับ ไม่ใช่กุญแจบัญชีบริการของโปรเจ็กต์

   คำขอยืนยันต้องใช้ข้อมูลติดต่อของแบรนด์ อย่างไรก็ตาม กระบวนการยืนยันจะไม่ส่งอีเมลถึงแบรนด์หากชื่อตัวแทนตรงกับชื่อ Business Profile และหากคุณได้รับโทเค็น OAuth ที่มีขอบเขตที่ถูกต้อง

   หากคุณทําถูกต้อง เอาต์พุตจากคําขอยืนยันควรแสดง verificationState ของ VERIFICATION_STATE_VERIFIED ทันที หาก verificationState แสดงผลเป็นค่าอื่น แสดงว่าคุณอาจไม่ได้ใช้โทเค็น OAuth ที่ถูกต้องเมื่อส่งคำขอ หรือระบบจับคู่ตัวแทนกับสถานที่ตั้ง Business Profile ไม่ได้

5. ใช้โทเค็น OAuth เดียวกันเพื่อขอการยืนยันสถานที่ตั้งสำหรับสถานที่ตั้งทั้งหมดที่ธุรกิจเป็นเจ้าของใน Business Profile

   เช่นเดียวกับการยืนยันตัวแทน หากคุณทําถูกต้อง เอาต์พุตจากคําขอยืนยันควรแสดง verificationState ของ VERIFICATION_STATE_VERIFIED ทันที หาก verificationState แสดงผลลัพธ์อื่น แสดงว่าคุณอาจไม่ได้ใช้โทเค็น OAuth ที่ถูกต้องเมื่อส่งคำขอ หรือสถานที่ตั้งของ Business Profile ไม่ใช่ธุรกิจที่อ้างสิทธิ์และยืนยันแล้ว

6. เปิดใช้งานตัวแทนด้วยจุดแรกเข้า LOCATION

7. เปิดใช้การรับส่งข้อความสำหรับสถานที่ตั้งบางแห่งโดยเปิดสถานที่ตั้งที่ต้องการให้บริการผ่าน Search และ Maps เมื่อกระบวนการเปิดตัวเริ่มต้นขึ้น การรับส่งข้อความสำหรับสถานที่ตั้งที่เปิดตัวแต่ละแห่งจะพร้อมให้บริการแก่ผู้ใช้ภายในไม่กี่ชั่วโมง

เมื่อทำตามขั้นตอนเหล่านี้ ระบบจะโพสต์ข้อความทั้งหมดของผู้บริโภคไปยัง Webhook ของ Business Messages ที่ลงทะเบียนไว้ และคุณต้องส่งการตอบกลับไปยังผู้บริโภคด้วย Business Messages API