Package google.mybusiness.verifications.v1

ดัชนี

• Verifications (อินเทอร์เฟซ)
• VoiceOfMerchant (อินเทอร์เฟซ)
• CompleteVerificationRequest (ข้อความ)
• CompleteVerificationResponse (ข้อความ)
• ComplyWithGuidelines (ข้อความ)
• ComplyWithGuidelines.RecommendationReason (enum)
• FetchVerificationOptionsRequest (ข้อความ)
• FetchVerificationOptionsResponse (ข้อความ)
• GetVoiceOfMerchantStateRequest (ข้อความ)
• ListVerificationsRequest (ข้อความ)
• ListVerificationsResponse (ข้อความ)
• ResolveOwnershipConflict (ข้อความ)
• ServiceBusinessContext (ข้อความ)
• Verification (ข้อความ)
• Verification.State (enum)
• VerificationMethod (enum)
• VerificationOption (ข้อความ)
• VerificationOption.AddressVerificationData (ข้อความ)
• VerificationOption.EmailVerificationData (ข้อความ)
• VerificationToken (ข้อความ)
• Verify (ข้อความ)
• VerifyLocationRequest (ข้อความ)
• VerifyLocationResponse (ข้อความ)
• VoiceOfMerchantState (ข้อความ)
• WaitForVoiceOfMerchant (ข้อความ)

การยืนยัน

API นี้อนุญาตให้จัดการการยืนยันตำแหน่งบน Google ซึ่งช่วยให้คุณจัดการทรัพยากร [การยืนยัน] [google.mybusiness.v1. Verification] ได้

[สถานที่] [google.mybusiness.businessinformation.locations.v1.Location] แต่ละแห่งมีคอลเล็กชันของแหล่งข้อมูล [การยืนยัน] [google.mybusiness.verifications] ที่มีชื่อว่า locations/*/verifications/*

CompleteVerification
rpc CompleteVerification(CompleteVerificationRequest) returns (CompleteVerificationResponse) ทําการยืนยัน PENDING จนเสร็จสมบูรณ์ จำเป็นต้องใช้วิธีการยืนยันที่ไม่ใช่ AUTO เท่านั้น คำขอยืนยัน AUTO จะมีการVERIFIEDทันทีที่สร้าง ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/business.manage ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

FetchVerificationOptions
rpc FetchVerificationOptions(FetchVerificationOptionsRequest) returns (FetchVerificationOptionsResponse) รายงานตัวเลือกการยืนยันที่มีสิทธิ์ทั้งหมดสำหรับสถานที่ตั้งในภาษาใดภาษาหนึ่ง ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/business.manage ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

ListVerifications
rpc ListVerifications(ListVerificationsRequest) returns (ListVerificationsResponse) แสดงการยืนยันสถานที่ โดยเรียงลำดับตามเวลาที่สร้าง ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/business.manage ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

VerifyLocation
rpc VerifyLocation(VerifyLocationRequest) returns (VerifyLocationResponse) เริ่มกระบวนการยืนยันสถานที่ตั้ง ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/business.manage ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

VoiceOfMerchant

บริการนี้อนุญาตให้ผู้ใช้บุคคลที่สามขอรายละเอียดเกี่ยวกับเสียงเกี่ยวกับสถานะของผู้ขายได้

GetVoiceOfMerchantState
rpc GetVoiceOfMerchantState(GetVoiceOfMerchantStateRequest) returns (VoiceOfMerchantState) รับสถานะ VoiceOfMerchant ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/business.manage ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

CompleteVerificationRequest

ข้อความคำขอสำหรับ VerificationsComplete VerificationAction

ช่อง
name	string ต้องระบุ ชื่อทรัพยากรของการยืนยันที่ต้องดำเนินการ
pin	string ต้องระบุ รหัส PIN ที่ผู้ขายได้รับเพื่อดำเนินการยืนยันให้เสร็จสมบูรณ์

CompleteVerificationResponse

ข้อความตอบกลับสำหรับ Verifications.CompleteVerificationAction

ช่อง
verification	Verification การยืนยันเสร็จสมบูรณ์แล้ว

ComplyWithGuidelines

ระบุว่าสถานที่ไม่เป็นไปตามหลักเกณฑ์ของเรา

ช่อง
recommendation_reason	RecommendationReason เหตุผลที่แนะนำสถานที่เพื่อให้สอดคล้องกับหลักเกณฑ์

RecommendationReason

ระบุเหตุผลที่แนะนำให้ใช้ตำแหน่งดังกล่าวเพื่อให้สอดคล้องกับคำแนะนำ

Enum
RECOMMENDATION_REASON_UNSPECIFIED	ไม่ได้ระบุ
BUSINESS_LOCATION_SUSPENDED	ที่ตั้งธุรกิจถูกระงับ หากต้องการแก้ไขปัญหานี้ โปรดดูบทความในศูนย์ช่วยเหลือ
BUSINESS_LOCATION_DISABLED	ที่ตั้งธุรกิจถูกปิดใช้งาน หากต้องการแก้ไขปัญหานี้ โปรดดูบทความในศูนย์ช่วยเหลือ

FetchVerificationOptionsRequest

ข้อความคำขอสำหรับ Verifications.FetchVerificationOptions

ช่อง
location	string ต้องระบุ สถานที่ที่จะยืนยัน
language_code	string ต้องระบุ รหัสภาษา BCP 47 ที่แสดงถึงภาษาที่จะใช้ในกระบวนการยืนยัน ตัวเลือกที่มีให้จะแตกต่างกันไปตามภาษา
context	ServiceBusinessContext ไม่บังคับ ข้อมูลบริบทเพิ่มเติมสำหรับการยืนยันธุรกิจบริการ ใช้ได้กับสถานที่ตั้งที่มีประเภทธุรกิจ CUSTOMER_LOCATION_ONLY เท่านั้น การระบุที่อยู่ที่ถูกต้องอาจช่วยให้มีตัวเลือกมากขึ้น nofollow_ARGUMENT จะถูกทิ้งหากได้ตั้งค่าไว้สำหรับสถานที่ประเภทอื่น

FetchVerificationOptionsResponse

ข้อความตอบกลับสำหรับ Verifications.Fetch VerificationOptions

ช่อง
options[]	VerificationOption ตัวเลือกการยืนยันที่ใช้ได้

GetVoiceOfMerchantStateRequest

ข้อความคำขอสำหรับ VoiceOfMerchant.GetVoiceOfMerchantState

ช่อง
name	string ต้องระบุ ชื่อทรัพยากรของตำแหน่ง

ListVerificationsRequest

ข้อความคำขอสำหรับ Verifications.ListConfirms

ช่อง
parent	string ต้องระบุ ชื่อทรัพยากรของสถานที่ตั้งที่มีคำขอการยืนยัน
page_size	int32 จำนวนการยืนยันที่จะรวมต่อหน้าเว็บ ค่าต่ำสุดคือ 1 และขนาดหน้าเริ่มต้นและสูงสุดคือ 100
page_token	string หากระบุไว้ ระบบจะแสดงหน้าถัดไปในการยืนยัน

ListVerificationsResponse

ข้อความตอบกลับสำหรับ Verifications.ListVerifications

ช่อง
verifications[]	Verification รายการการยืนยัน
next_page_token	string หากจำนวนการยืนยันเกินกว่าขนาดหน้าเว็บที่ร้องขอ ระบบจะป้อนข้อมูลในฟิลด์นี้พร้อมด้วยโทเค็นเพื่อดึงข้อมูลหน้าถัดไปในการโทรครั้งถัดไป หากไม่มีแอตทริบิวต์เพิ่มเติม ระบบจะไม่แสดงช่องนี้ในการตอบกลับ

ResolveOwnershipConflict

ประเภทนี้ไม่มีช่อง

ระบุว่าสถานที่นั้นซ้ำกับสถานที่อื่นที่อยู่ในสถานะดี

ServiceBusinessContext

ข้อมูลเพิ่มเติมสำหรับการยืนยันธุรกิจที่ให้บริการ

ช่อง
address	PostalAddress ที่อยู่ที่ยืนยันแล้วของสถานที่ตั้ง มีไว้เพื่อเปิดใช้ตัวเลือกการยืนยันเพิ่มเติมหรือส่งไปรษณียบัตร

การยืนยัน

การยืนยันหมายถึงความพยายามในการยืนยันสถานที่

ช่อง
name	string ชื่อทรัพยากรของการยืนยัน
method	VerificationMethod วิธีการยืนยัน
state	State สถานะของการยืนยัน
create_time	Timestamp การประทับเวลาเมื่อมีการขอการยืนยัน
announcement	string ไม่บังคับ ตั้งค่าประกาศการตอบกลับเฉพาะเมื่อวิธีการคือ VETTED_PARTNER

รัฐ

สถานะการยืนยันที่เป็นไปได้ทั้งหมด

Enum
STATE_UNSPECIFIED	ค่าเริ่มต้นจะทำให้เกิดข้อผิดพลาด
PENDING	กำลังรอการยืนยัน
COMPLETED	การยืนยันเสร็จสมบูรณ์แล้ว
FAILED	การยืนยันล้มเหลว

VerificationMethod

ระบุขั้นตอนที่ Google ใช้เพื่อยืนยันสถานที่ตั้ง

Enum
VERIFICATION_METHOD_UNSPECIFIED	ค่าเริ่มต้นจะทำให้เกิดข้อผิดพลาด
ADDRESS	ส่งไปรษณียบัตรที่มี PIN ยืนยันไปยังที่อยู่จัดส่งที่ระบุ PIN จะใช้เพื่อดำเนินการยืนยันกับ Google ให้เสร็จสมบูรณ์
EMAIL	ส่งอีเมลที่มี PIN ยืนยันไปยังที่อยู่อีเมลที่เฉพาะเจาะจง PIN จะใช้เพื่อดำเนินการยืนยันกับ Google ให้เสร็จสมบูรณ์
PHONE_CALL	โทรออกโดยใช้ PIN ยืนยันไปยังหมายเลขโทรศัพท์ที่ระบุ PIN จะใช้เพื่อดำเนินการยืนยันกับ Google ให้เสร็จสมบูรณ์
SMS	ส่ง SMS พร้อม PIN ยืนยันไปยังหมายเลขโทรศัพท์เฉพาะ PIN จะใช้เพื่อดำเนินการยืนยันกับ Google ให้เสร็จสมบูรณ์
AUTO	ยืนยันสถานที่โดยไม่ต้องมีการดำเนินการเพิ่มเติมจากผู้ใช้ ตัวเลือกนี้อาจไม่มีให้ใช้ในบางสถานที่
VETTED_PARTNER	ตัวเลือกนี้อาจไม่มีให้ใช้ในบางสถานที่

VerificationOption

ตัวเลือกการยืนยันจะแสดงวิธียืนยันสถานที่ (ระบุโดยวิธีการยืนยัน) และปลายทางที่จะรับการยืนยัน (ระบุข้อมูลที่แสดง)

ช่อง
verification_method	VerificationMethod วิธียืนยันสถานที่
ฟิลด์การรวม DisplayData หนึ่งในข้อมูลที่แสดง ข้อมูลต้องตรงกับเมธอด เว้นว่างไว้หากวิธีการที่เกี่ยวข้องไม่มีข้อมูลที่แสดง DisplayData ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
phone_number	string ตั้งค่าเฉพาะเมื่อวิธีการคือ PHONE_CALL หรือ SMS หมายเลขโทรศัพท์ที่จะส่ง PIN ไปให้
address_data	AddressVerificationData ตั้งค่าเมื่อเมธอดคือ MAIL เท่านั้น
email_data	EmailVerificationData ตั้งค่าเมื่อวิธีการคือ EMAIL เท่านั้น
announcement	string ตั้งค่าเมื่อวิธีการคือ VETTED_PARTNER เท่านั้น

AddressVerificationData

แสดงข้อมูลสำหรับการยืนยันผ่านไปรษณียบัตร

ช่อง
business	string ชื่อธุรกิจของผู้ขาย
address	PostalAddress ที่อยู่ที่ไปรษณียบัตรส่งไปได้
expected_delivery_days_region	int32 จำนวนวันโดยประมาณที่ต้องใช้ในการจัดส่งไปรษณียบัตรไปยังภูมิภาคของที่อยู่

EmailVerificationData

แสดงข้อมูลสำหรับการยืนยันทางอีเมล

ช่อง
domain	string ชื่อโดเมนในที่อยู่อีเมล เช่น "gmail.com" ใน [e-mail]
user	string ชื่อผู้ใช้ในอีเมล เช่น "foo" ใน [e-mail]
is_user_name_editable	bool ลูกค้าได้รับอนุญาตให้ระบุชื่อผู้ใช้เป็นอย่างอื่นหรือไม่

VerificationToken

โทเค็นที่สร้างโดยพาร์ทเนอร์ที่ผ่านการตรวจสอบ

ช่อง
token_string	string สตริงโทเค็น

ยืนยัน

ระบุว่าสถานที่ต้องได้รับการยืนยัน มีข้อมูลเกี่ยวกับการดำเนินการยืนยันในปัจจุบันที่ทำกับสถานที่ตั้ง

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

VerifyLocationRequest

ข้อความคำขอสำหรับ Verifications.VerifyLocation

ช่อง
name	string ต้องระบุ ชื่อทรัพยากรของสถานที่ตั้งที่จะยืนยัน
method	VerificationMethod ต้องระบุ วิธีการยืนยัน
language_code	string ไม่บังคับ รหัสภาษา BCP 47 ที่แสดงถึงภาษาที่จะใช้ในกระบวนการยืนยัน
context	ServiceBusinessContext ไม่บังคับ ข้อมูลบริบทเพิ่มเติมสำหรับการยืนยันธุรกิจบริการ จำเป็นต้องระบุเฉพาะสถานที่ที่มีประเภทธุรกิจ CUSTOMER_LOCATION_ONLY เท่านั้น สำหรับการยืนยันที่อยู่ ระบบจะใช้ที่อยู่เพื่อส่งไปรษณียบัตร สำหรับวิธีการอื่นๆ วิธีการนั้นควรเหมือนกับวิธีการที่ส่งไปยัง GetVerificationOptions nofollow_ARGUMENT จะถูกทิ้งหากตั้งค่าไว้สำหรับที่ตั้งธุรกิจประเภทอื่นๆ
ฟิลด์การรวม RequestData ข้อมูลอินพุตของผู้ใช้สำหรับวิธีการที่เฉพาะเจาะจงนอกเหนือจากข้อมูลการแสดงผล ข้อมูลต้องตรงกับเมธอดที่ขอ ปล่อยว่างไว้หากไม่จำเป็นต้องใช้ข้อมูล RequestData ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
email_address	string ไม่บังคับ อินพุตสำหรับเมธอด EMAIL ที่อยู่อีเมลที่ควรส่ง PIN ไปให้ ระบบจะยอมรับอีเมลเฉพาะในกรณีที่อีเมลนั้นเป็นหนึ่งในที่อยู่ที่ FetchVerificationOptions ระบุไว้เท่านั้น หาก [EmailConfirmData] [google.mybusiness-verifications.v1. VerificationOption.EmailVerificationData] ตั้งค่า is_user_name_editable เป็น "จริง" ไคลเอ็นต์อาจระบุชื่อผู้ใช้อื่น (local-part) แต่ต้องตรงกับชื่อโดเมน
mailer_contact	string ไม่บังคับ อินพุตสำหรับเมธอด ADDRESS ชื่อผู้ติดต่อที่ควรส่งอีเมล
phone_number	string ไม่บังคับ อินพุตสำหรับวิธี PHONE_CALL/SMS หมายเลขโทรศัพท์ที่ควรโทรหาหรือส่ง SMS ถึง ต้องเป็นหมายเลขโทรศัพท์หนึ่งในตัวเลือกที่มีสิทธิ์
token	VerificationToken ไม่บังคับ อินพุตสำหรับเมธอด VETTED_PARTNER ที่มีให้สำหรับpartners.ที่เลือก ไม่จำเป็นต้องป้อนข้อมูลสำหรับบัญชีที่ได้รับการตรวจสอบแล้ว โทเค็นที่เชื่อมโยงกับสถานที่ตั้ง โทเค็นที่เชื่อมโยงกับสถานที่ตั้ง

VerifyLocationResponse

ข้อความตอบกลับสำหรับ Verifications.VerifyLocation

ช่อง
verification	Verification คำขอการยืนยันที่สร้าง

VoiceOfMerchantState

ข้อความตอบกลับสำหรับ VoiceOfMerchant.GetVoiceOfMerchantState

ช่อง
has_voice_of_merchant	bool ระบุว่าสถานที่ตั้งอยู่ในสถานะดีและมีสิทธิ์ควบคุมธุรกิจใน Google หรือไม่ การแก้ไขสถานที่จะเผยแพร่ใน Maps หลังจากผ่านขั้นตอนการตรวจสอบ
has_business_authority	bool ระบุว่าสถานที่มีสิทธิ์ (การเป็นเจ้าของ) เหนือธุรกิจบน Google หรือไม่ หากเป็นจริง สถานที่อื่นจะไม่สามารถเข้ามาแทนที่และกลายเป็นรายชื่อที่โดดเด่นบน Maps อย่างไรก็ตาม การแก้ไขจะไม่มีผล เว้นแต่จะได้รับ Voice of Merchant (นั่นคือ has_voice_of_merchant เป็นจริง)
ฟิลด์การรวม gain_voice_of_merchant_action การดำเนินการที่แนะนำแก่สถานที่ตั้งดังกล่าวเพื่อให้ควบคุมธุรกิจบน Google ได้ gain_voice_of_merchant_action ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
wait_for_voice_of_merchant	WaitForVoiceOfMerchant รอรับ Voice of Merchant สถานที่อยู่ระหว่างตรวจสอบเพื่อวัตถุประสงค์ด้านคุณภาพ
verify	Verify เริ่มต้นหรือดำเนินการต่อตามกระบวนการยืนยันตัวตน
resolve_ownership_conflict	ResolveOwnershipConflict สถานที่นี้ซ้ำกับอีกสถานที่หนึ่งที่อยู่ในสถานะดี หากคุณมีสิทธิ์เข้าถึงสถานที่ตั้งโดยอยู่ในสถานะดี ให้ใช้รหัสของสถานที่ตั้งนั้นในการดำเนินการ หรือขอสิทธิ์เข้าถึงจากเจ้าของปัจจุบัน
comply_with_guidelines	ComplyWithGuidelines สถานที่ไม่เป็นไปตามหลักเกณฑ์ของเรา และต้องมีขั้นตอนเพิ่มเติมในการคืนสิทธิ หากต้องการแก้ไขปัญหานี้ โปรดดูบทความในศูนย์ช่วยเหลือ

WaitForVoiceOfMerchant

ประเภทนี้ไม่มีช่อง

ระบุว่าสถานที่จะได้รับเสียงจากผู้ขายหลังจากผ่านการตรวจสอบ