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

ผู้ให้บริการที่เสนอการจัดการข้อมูลในแพลตฟอร์มของตนโดยตรงจะยืนยันธุรกิจของผู้ขายในเว็บไซต์ของตนได้ ซึ่งทำให้ผู้ขายไม่ต้องเปลี่ยนเส้นทางไปยัง 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. เรียกใช้เมธอด GetVoiceOfMerchant API เพื่อยืนยันว่าตำแหน่งนั้นต้องได้รับการยืนยันหรือไม่
  4. หากคำตอบแสดงผลเป็น "ยืนยัน" ให้โทรหา fetchVerificationOptions เพื่อดูรายการวิธีการที่ใช้ยืนยันสถานที่ตั้งนั้นได้
  5. ตรวจสอบอีกครั้งว่าข้อมูล verificationOption มีที่อยู่ หมายเลขโทรศัพท์ และอีเมลที่ถูกต้อง
  6. หลังจากผู้ขายเลือกตัวเลือกการยืนยันที่เหมาะสมที่สุดแล้ว ให้เรียกใช้เมธอด locations.verify เพื่อเริ่มการยืนยันที่เหมาะสม หากต้องการยืนยันว่าการเริ่มต้นดำเนินการอยู่ระหว่างดำเนินการ ให้โทรหา locations.verifications.list.
  7. เรียกใช้เมธอด locations.verification.complete ด้วย PIN ของผู้ขาย
  8. เรียกใช้เมธอด GetVoiceOfMerchant API หากเป็น HasVoiceOfMerchant = true แสดงว่าคุณยืนยันสถานที่เรียบร้อยแล้ว

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

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

คู่มือวิธีการยืนยันสําหรับพาร์ทเนอร์ที่ได้รับการตรวจสอบแล้ว