Method: projects.optimizeToursUri

هذه طريقة مختلفة عن طريقة projects.optimizeToursLongRunning وهي مصمّمة للتحسينات التي تستخدم قيم مهلة كبيرة وحجم إدخال/إخراج كبير.

يحدِّد العميل معرّف الموارد المنتظم (URI) لملف OptimizeToursRequest المخزَّن في Google Cloud Storage، ويكتب الخادم OptimizeToursResponse في معرّف الموارد المنتظم (URI) الذي حدّده العميل في Google Cloud Storage.

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

سيكون للعنصر long-running operation (LRO) الذي يتم إرجاعه اسم بالتنسيق <parent>/operations/<operation_id> ويمكن استخدامه لتتبُّع مستوى تقدّم عملية الحساب. نوع الحقل metadata هو OptimizeToursLongRunningMetadata. نوع الحقل response هو OptimizeToursUriResponse، في حال نجاح العملية.

طلب HTTP

POST https://routeoptimization.googleapis.com/v1/{parent=projects/*}:OptimizeToursUri

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

مطلوب. استهدِف المشروع أو الموقع الجغرافي لإجراء مكالمة.

التنسيق: * projects/{project-id} * projects/{project-id}/locations/{location-id}

في حال عدم تحديد موقع جغرافي، سيتم اختيار منطقة تلقائيًا.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "input": {
    object (Uri)
  },
  "output": {
    object (Uri)
  }
}
الحقول
input

object (Uri)

مطلوب. معرّف الموارد المنتظم لعنصر Cloud Storage الذي يحتوي على OptimizeToursRequest.
output

object (Uri)

مطلوب. معرّف الموارد المنتظم (URI) لعنصر Cloud Storage الذي سيحتوي على OptimizeToursResponse.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation.

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

يجب توفير نطاق OAuth التالي:

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

أذونات إدارة الهوية والوصول

يتطلب هذا الإجراء الحصول على إذن IAM التالي في مورد parent:

  • routeoptimization.operations.create

لمزيد من المعلومات، يُرجى الاطّلاع على مستندات إدارة الهوية وإمكانية الوصول.