Package google.cloud.location

الفهرس

المواقع الجغرافية

يشير ذلك المصطلح إلى واجهة مجردة توفّر معلومات عن الموقع الجغرافي لإحدى الخدمات. يتم توفير البيانات الوصفية الخاصة بالخدمة من خلال الحقل Location.metadata.

الحصول على موقع

rpc GetLocation(GetLocationRequest) returns (Location)

الحصول على معلومات حول موقع جغرافي

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة حول المصادقة.

المواقع الجغرافية المدرَجة في القائمة

rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse)

يسرد معلومات عن المواقع الجغرافية المتاحة لهذه الخدمة.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة حول المصادقة.

طلب GetLocationRequest

رسالة الطلب لـ Locations.GetLocation.

الحقول
name

string

اسم المورد للموقع الجغرافي.

طلب ListLocations

رسالة الطلب لـ Locations.ListLocations.

الحقول
name

string

تمثّل هذه السمة المورد الذي يملك مجموعة المواقع الجغرافية، إذا كان ذلك منطبقًا.

filter

string

فلتر لتضييق نطاق النتائج إلى مجموعة فرعية مفضّلة. وتقبل لغة الفلترة السلاسل مثل "displayName=tokyo"، وقد تم توثيقها بمزيد من التفاصيل في AIP-160.

page_size

int32

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

page_token

string

رمز مميّز لصفحة تم تلقّيه من الحقل next_page_token في الردّ. عليك إرسال الرمز المميّز للصفحة لاستلام الصفحة التالية.

استجابة ListLocations

رسالة الردّ على Locations.ListLocations.

الحقول
locations[]

Location

قائمة بالمواقع الجغرافية التي تتطابق مع الفلتر المحدّد في الطلب

next_page_token

string

الرمز المميز القياسي للصفحة التالية في القائمة.

الموقع الجغرافي

يشير هذا المصطلح إلى مورد يمثّل موقعًا جغرافيًا على Google Cloud.

الحقول
name

string

اسم المورد للموقع الجغرافي، والذي قد يختلف بين عملية تنفيذ واحدة مثلاً: "projects/example-project/locations/us-east1"

location_id

string

رقم التعريف الأساسي لهذا الموقع. مثلاً: "us-east1"

display_name

string

الاسم المألوف لهذا الموقع الجغرافي، والذي يكون عادةً اسم مدينة قريبة على سبيل المثال، "طوكيو".

labels

map<string, string>

سمات الخدمات المتعددة للموقع الجغرافي. على سبيل المثال:

{"cloud.googleapis.com/region": "us-east1"}
metadata

Any

البيانات الوصفية الخاصة بالخدمة. على سبيل المثال، السعة المتوفّرة في الموقع الجغرافي المحدّد.