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)

REQUIRED: نسخة هذا الطلب.

الإصدار

كائن الإصدار، وهو شكل منظَّم لبنية إصدار a.b.c الكلاسيكية. نضمن لك توافق الإصدارات الرئيسية التي لها الرقم نفسه. لاحظ أن المراجعات الثانوية والمراجعات يمكن أن تتغير بشكل متكرر وبدون إشعار. يجب أن تقدّم شركة الدمج جميع الطلبات الخاصة بالإصدار الرئيسي نفسه.

تمثيل JSON
{
  "major": integer,
  "minor": integer,
  "revision": integer
}
الحقول
major

integer

مطلوب: رقم الإصدار الرئيسي. ويتم وضع علامة على هذا الخيار بأنّه لا يمكن ضمان توافق طلبات التوافق مع الإصدارات المختلفة.

minor

integer

REQUIRED: الإصدار الثانوي. ويدل هذا على إصلاحات كبيرة للأخطاء.

revision

integer

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