Method: verificationTokens.generate

יוצרים טוקן לנתוני המיקום שסופקו כדי לאמת את המיקום.

בקשת HTTP

POST https://mybusinessverifications.googleapis.com/v1/verificationTokens:generate

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "locationId": string
  // End of mutually exclusive fields.
}
שדות
פרטי המיקום שעבורו רוצים ליצור אסימון אימות מיידי. ברשימה הבאה מפורטים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
locationId

string

מזהה המיקום שמשויך לתוצאה לא מאומתת.

זהו מזהה המיקום שנוצר בזמן שבו הדף נוצר במקור. זה החלק האחרון של שם המשאב של המיקום, כפי שנוצר על ידי Business Information API.

הערה: המתקשר חייב להיות הבעלים או המנהל של הדף העסקי הזה כדי ליצור אסימון אימות.

מידע נוסף זמין במסמכי התיעוד של משאב המיקום.
סוף השדות שמוציאים זה את זה.

גוף התשובה

הודעת תגובה ל-Verifications.GenerateInstantVerificationToken.

אם הפעולה מצליחה, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "result": enum (Result),
  "instantVerificationToken": string
}
שדות
result

enum (Result)

פלט בלבד. התוצאה של יצירת טוקן האימות המיידי.
instantVerificationToken

string

טוקן האימות המיידי שנוצר.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

תוצאה

טיפוסים בני מנייה (enum)
RESULT_UNSPECIFIED ערך ברירת המחדל, יגרום לשגיאות.
SUCCEEDED טוקן האימות המיידי נוצר בהצלחה.
FAILED טוקן האימות המיידי לא נוצר.