אובייקט כותרת שמוגדר בכל הבקשות שנשלחות לשרת.
ייצוג JSON |
---|
{
"requestId": string,
"requestTimestamp": string,
"userLocale": string,
"protocolVersion": {
object ( |
שדות | |
---|---|
requestId |
חובה: המזהה הייחודי של הבקשה. האורך המקסימלי של מחרוזת זו הוא 100 תווים, והיא מכילה רק את התווים "a-z" , "A-Z" , "0-9" , ":" "-" ו-"_". |
requestTimestamp |
REQUIRED: חותמת הזמן של הבקשה הזו, מיוצגת באלפיות השנייה מאז epoch. על המקבל לאמת שחותמת הזמן הזו היא בטווח של ± 60 שניות עכשיו. חותמת הזמן של הבקשה הזו לא אידמפוטנטית לאחר ניסיונות חוזרים. |
userLocale |
הוצא משימוש: קוד שפה בן שתי אותיות או שלוש אותיות לפי תקן ISO 639-2 Alpha 3, אופציונלי ואחריו מקף וקוד מדינה בפורמט ISO 3166-1 Alpha-2, למשל 'pt', 'pt-BR', 'fil' או 'fil-PH'. אפשר להשתמש במדד הזה כדי להציג את השדות |
protocolVersion |
חובה: גרסת הבקשה. |
גרסה
אובייקט גרסה שהוא צורה מובנית של המבנה הקלאסי של הגרסה a.b.c
. מובטחת תאימות לגרסאות ראשיות של אותו מספר. הערה: עריכות קלות ותיקונים עשויים להשתנות לעיתים קרובות וללא הודעה מוקדמת. מבצע השילוב צריך לתמוך בכל הבקשות לאותה גרסה ראשית.
ייצוג JSON |
---|
{ "major": integer, "minor": integer, "revision": integer } |
שדות | |
---|---|
major |
חובה: הגרסה הראשית. הוא מסומן עבור בקשות תאימות עם גרסאות שונות לא מובטח שהן יעמדו בתאימות. |
minor |
חובה: הגרסה המשנית. ישנם תיקוני באגים משמעותיים. |
revision |
חובה: הגרסה המשנית. בוצעו תיקוני באגים קלים. |