เริ่มต้นใช้งานสถานที่จาก 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 ร้านเบเกอรี่แสงแดด" แต่ไม่ตรงกับ "เบเกอรี่ซานฟรานซิสโก"

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

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

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

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

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

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

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

6. เปิด Agent ที่มีจุดแรกเข้า LOCATION

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

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