RequestMetadata

فراداده مربوط به درخواست، که در همه درخواست‌ها الزامی است.

نمایش JSON 
{
  "requestId": string,
  "version": {
    object (Version)
  },
  "issuerId": string
}
فیلدها
requestId

string

شناسه‌ای که برای شناسایی این درخواست خاص استفاده می‌شود و باید برای هر تلاش مجدد متفاوت باشد.

این برای اهداف اشکال‌زدایی، مانند شناسایی درخواست‌هایی که ناموفق بوده‌اند، استفاده می‌شود. هیچ الزام idempotency به این مورد ضمیمه نشده است.

مثال: شناسه کاربری

version

object ( Version )

نسخه API مورد استفاده.

این باید با نسخه API پیاده‌سازی شده توسط سرور بررسی شود و در صورت عدم تطابق، درخواست باید رد شود.

issuerId

string

شناسه صادرکننده‌ای که گوگل با آن ارتباط برقرار می‌کند.

این می‌تواند برای فیلتر کردن سریع ترافیک صادرکننده خاص هنگام اشکال‌زدایی استفاده شود.

مثال: FreeFormState_ISO2Country_MDL

نسخه

یک شیء که نشان‌دهنده‌ی نسخه API است.

نمایش JSON 
{
  "major": integer,
  "minor": integer
}
فیلدها
major

integer

شماره نسخه اصلی API.

مثال: برای نسخه ۱.۲، این عدد ۱ خواهد بود

minor

integer

شماره نسخه فرعی API.

مثال: برای نسخه ۱.۲، این عدد ۲ خواهد بود