RequestHeader

كائن العنوان المحدد في جميع الطلبات المرسلة إلى الخادم.

تمثيل JSON
{
  "requestId": string,
  "requestTimestamp": string,
  "userLocale": string,
  "protocolVersion": {
    object (Version)
  }
}
الحقول
requestId

string

مطلوبة: معرّف فريد لهذا الطلب

وهذه السلسلة تتكون من 100 حرف كحد أقصى، ولا تحتوي إلا على الأحرف "a-z" و"A-Z" و"0-9" و":" و-" و"_".

requestTimestamp

string (int64 format)

مطلوب: الطابع الزمني لهذا الطلب الذي تم تمثيله بالمللي ثانية منذ البداية. يجب أن يتحقّق المستلِم من أنّ هذا الطابع الزمني يساوي ±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

مطلوب: إصدار ثانوي. ويشير هذا إلى إصلاحات الأخطاء البسيطة.