Package google.cloud.location

الفهرس

• Locations (واجهة)
• GetLocationRequest (رسالة)
• ListLocationsRequest (رسالة)
• ListLocationsResponse (رسالة)
• 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 البيانات الوصفية الخاصة بالخدمة. على سبيل المثال، السعة المتوفّرة في الموقع الجغرافي المحدّد.