จัดการการยืนยัน

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

รับสถานะปัจจุบัน

ผู้ใช้สามารถโทรหา locations.getVoiceOfMerchantState ในสถานที่ตั้งเพื่อดึงข้อมูลสถานะปัจจุบันของสถานที่ตั้ง หาก hasVoiceOfMerchant บูลีนเป็น true แสดงว่าสถานที่ตั้งอยู่ในสถานะดีอยู่แล้วและไม่จำเป็นต้องดำเนินการใดๆ เพิ่มเติม มิเช่นนั้น หากgain_voice_of_merchantการดำเนินการในการตอบกลับมี verify คุณต้องทำการยืนยันให้เสร็จสมบูรณ์ ทำตามวิธีการด้านล่างเพื่อดูข้อมูลเพิ่มเติม

ตัวเลือกการยืนยันการดึงข้อมูล

ผู้ให้บริการสามารถใช้วิธี locations.fetchVerificationOptions เพื่อแจ้งให้ผู้ขายเลือกวิธีการติดต่อที่ต้องการจากรายการวิธีการยืนยันที่มี

หากต้องการดึงตัวเลือกการยืนยัน ให้ใช้คำสั่งต่อไปนี้

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

เริ่มกระบวนการยืนยันตัวตน

หลังจากเลือกวิธีการยืนยันแล้ว ให้เริ่มกระบวนการยืนยันด้วย locations.verify การเรียกนี้จะส่งผลให้สถานที่จะเปลี่ยนเป็นสถานะ "ยืนยันแล้ว" หรือระบบจะแสดงสถานะข้อผิดพลาด

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
:verify

// Use only one of the below verification methods

// For postcard verification:
{
  "method": "ADDRESS",
  "languageCode": "en",
  "addressInput": {
    "mailerContactName": "Ann Droyd"
  }
}

// For phone verification:
{
  "method": "PHONE_CALL",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For SMS verification:
{
  "method": "SMS",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For email verification:
{
  "method": "EMAIL",
  "languageCode": "en",
  "emailInput": {
    "emailAddress": "ex@google.com"
  }
}

ดึงข้อมูลการยืนยันปัจจุบัน

การเรียก locations.verifications.list จะดึงประวัติคำขอการยืนยันพร้อมสถานะของคำขอสำหรับสถานที่ที่ระบุในการเรียก

หากต้องการดึงคำขอการยืนยันทั้งหมด ให้ใช้คำสั่งต่อไปนี้

HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

ทำการยืนยันที่รอดำเนินการให้เสร็จสมบูรณ์

โดยปกติแล้วจะต้องใช้รหัส PIN และวิธีการ locations.verifications.complete เพื่อยืนยันธุรกิจให้เสร็จสมบูรณ์

หากต้องการยืนยันที่รอดำเนินการให้เสร็จสมบูรณ์ ให้ใช้ข้อมูลต่อไปนี้

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}

แนวทางปฏิบัติแนะนำสำหรับการยืนยัน GBP โดยใช้ API

การสร้างสถานที่

GBP Business Information API ช่วยให้คุณฝังแพลตฟอร์มเพื่อมอบฟังก์ชันการสร้างสถานที่ตั้งได้ เมื่อขอให้ผู้ขายเพิ่มสถานที่ตั้งใหม่ โปรดทำตามขั้นตอนต่อไปนี้

รวบรวมข้อมูลสถานที่ตั้ง เช่น ชื่อธุรกิจ ที่อยู่ หมวดหมู่ จากผู้ขาย

  1. เรียกใช้ปลายทาง googleLocations.search
  2. ระบุข้อมูลสถานที่ตั้ง เช่น ชื่อธุรกิจ หมวดหมู่ ที่อยู่ หมายเลขโทรศัพท์ และเว็บไซต์ ในคำขอ API

หรือจะค้นหาสถานที่ที่อาจตรงกันโดยทำตามขั้นตอนต่อไปนี้ก็ได้

  1. ค้นหาสถานที่ที่อาจตรงกัน
  2. ขอให้ผู้ขายเลือกสถานที่ตั้งที่ถูกต้อง
  3. หาก requestAdminRightsUrl มีอยู่ในคำตอบของสถานที่ ให้ช่วยผู้ขายขอสิทธิ์เข้าถึงและความเป็นเจ้าของสถานที่นั้นใน Google Business Profile
  4. หากไม่มี requestAdminRightsUrl ให้สร้างสถานที่ตั้งใหม่โดยใช้รหัสสถานที่ในการตอบกลับสถานที่ตั้ง
  5. ยืนยันตำแหน่งใหม่

หมายเหตุ: หากไม่พบสถานที่ตั้งที่ตรงกันจากการค้นหาครั้งแรก ให้ใช้รหัสสถานที่ว่างเพื่อสร้างสถานที่ตั้งใหม่ จากนั้นยืนยันตำแหน่งใหม่

การยืนยันสถานที่ตั้ง

หากต้องการเริ่มกระบวนการยืนยันโดยใช้ GBP API โปรดทำตามขั้นตอนต่อไปนี้

  1. เรียกใช้เมธอด accounts.locations.list เพื่อแสดงสถานที่ตั้งทั้งหมดสำหรับบัญชี Google
  2. เลือกสถานที่ที่จะยืนยัน
  3. เรียกใช้เมธอด API GetVoiceOfMerchant เพื่อยืนยันว่าสถานที่ตั้งนั้นต้องได้รับการยืนยันหรือไม่
  4. หากการตอบกลับแสดง "ยืนยัน" ให้โทรหา fetchVerificationOptions เพื่อดูรายการวิธีการที่ใช้ได้ในการยืนยันสถานที่ตั้งนั้น
  5. ตรวจสอบอีกครั้งว่าverificationOptionข้อมูลมีที่อยู่ หมายเลขโทรศัพท์ และอีเมลที่ถูกต้อง
  6. หลังจากที่ผู้ขายเลือกตัวเลือกการยืนยันที่ดีที่สุดแล้ว ให้เรียกใช้เมธอด locations.verify เพื่อเริ่มการยืนยันที่เหมาะสม หากต้องการยืนยันว่าการเริ่มต้นกำลังดำเนินการอยู่ ให้โทรหา locations.verifications.list.
  7. เรียกใช้เมธอด locations.verification.complete ด้วย PIN ของผู้ขาย
  8. เรียกใช้เมธอด GetVoiceOfMerchant API หาก HasVoiceOfMerchant = true แสดงว่าคุณยืนยันสถานที่เรียบร้อยแล้ว

หมายเหตุ: หากAUTOการยืนยันพร้อมใช้งานสำหรับสถานที่ตั้ง ผู้ขายไม่จำเป็นต้องดำเนินการตามขั้นตอนการยืนยันใดๆ

ดูข้อมูลเพิ่มเติมเกี่ยวกับการยืนยัน GBP ได้ที่บทความสนับสนุนในศูนย์ช่วยเหลือ