Package google.cloud.location

الفهرس

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

واجهة مجردة توفر معلومات متعلقة بالموقع الجغرافي لخدمة. يتم توفير البيانات الوصفية الخاصة بالخدمة من خلال حقل Location.metadata.

GetLocation

rpc GetLocation(GetLocationRequest) returns (Location)

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

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

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

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

ListLocations

rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse)

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

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

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

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

GetLocationRequest

رسالة الطلب التي تخصّ Locations.GetLocation.

الحقول
name

string

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

ListLocationsRequest

رسالة الطلب التي تخصّ Locations.ListLocations.

الحقول
name

string

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

filter

string

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

page_size

int32

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

page_token

string

رمز مميّز للصفحة تم استلامه من حقل next_page_token في الردّ أرسِل الرمز المميّز للصفحة هذا لتلقّي الصفحة التالية.

ListLocationsResponse

رسالة الرد لـ 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

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