RequestHeader

אובייקט כותרת שמוגדר בכל הבקשות שנשלחות לשרת.

ייצוג JSON
{
  "requestId": string,
  "requestTimestamp": string,
  "userLocale": string,
  "protocolVersion": {
    object (Version)
  }
}
שדות
requestId

string

חובה: המזהה הייחודי של הבקשה.

האורך המקסימלי של מחרוזת זו הוא 100 תווים, והיא מכילה רק את התווים "a-z" , "A-Z" , "0-9" , ":" "-" ו-"_".

requestTimestamp

string (int64 format)

REQUIRED: חותמת הזמן של הבקשה הזו, מיוצגת באלפיות השנייה מאז epoch. על המקבל לאמת שחותמת הזמן הזו היא בטווח של ± 60 שניות עכשיו. חותמת הזמן של הבקשה הזו לא אידמפוטנטית לאחר ניסיונות חוזרים.

userLocale
(deprecated)

string

הוצא משימוש: קוד שפה בן שתי אותיות או שלוש אותיות לפי תקן ISO 639-2 Alpha 3, אופציונלי ואחריו מקף וקוד מדינה בפורמט ISO 3166-1 Alpha-2, למשל 'pt', 'pt-BR', 'fil' או 'fil-PH'. אפשר להשתמש במדד הזה כדי להציג את השדות userMessage בתשובה.

protocolVersion

object (Version)

חובה: גרסת הבקשה.

גרסה

אובייקט גרסה שהוא צורה מובנית של המבנה הקלאסי של הגרסה a.b.c. מובטחת תאימות לגרסאות ראשיות של אותו מספר. הערה: עריכות קלות ותיקונים עשויים להשתנות לעיתים קרובות וללא הודעה מוקדמת. מבצע השילוב צריך לתמוך בכל הבקשות לאותה גרסה ראשית.

ייצוג JSON
{
  "major": integer,
  "minor": integer,
  "revision": integer
}
שדות
major

integer

חובה: הגרסה הראשית. הוא מסומן עבור בקשות תאימות עם גרסאות שונות לא מובטח שהן יעמדו בתאימות.

minor

integer

חובה: הגרסה המשנית. ישנם תיקוני באגים משמעותיים.

revision

integer

חובה: הגרסה המשנית. בוצעו תיקוני באגים קלים.