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

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

استخدام OAuth (السيارات)

يتطلّب منح الإذن بطلباتك إلى annotatePaths حساب خدمة ضمن القائمة المسموح بها لمشروع Google Cloud المرتبط. ويمكنك بعد ذلك انتحال هوية حساب الخدمة وإنشاء رمز OAuth مميز يتم تمريره كرأس في الطلبات.

إعداد حساب خدمة

بما أنّه لا يُسمح إلا لحسابات الخدمة المدرَجة في القائمة المسموح بها بطلب البيانات على annotatePaths، عليك التصرّف كحساب خدمة من خلال انتحال هوية حساب الخدمة.

اتّبِع التعليمات الواردة في إنشاء حساب خدمة. يحتوي البريد الإلكتروني لحساب الخدمة على التنسيق العام التالي:
```
SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
```
أرسِل البريد الإلكتروني لحساب الخدمة إلى ممثل النشاط التجاري في Google. يضيف ممثّلك حساب الخدمة هذا إلى قائمة مسموح بها مسموح بطلب الاتصال annotatePaths.

إضافة المستخدمين الذين يمكنهم انتحال هوية حساب الخدمة

أضِف مستخدمًا مفوَّضًا لانتحال هوية حساب الخدمة:

gcloud iam service-accounts add-iam-policy-binding \
    SERVICE_ACCOUNT \
    --member=user:USER_EMAIL \
    --role=roles/iam.serviceAccountTokenCreator \
    --project=PROJECT_ID

يمكنك أيضًا إضافة مستخدمين مُصرَّح لهم بانتحال هوية حساب الخدمة من خلال Cloud Console. يُرجى الاطّلاع على إنشاء حساب خدمة.

تحديد المشاكل وحلّها في حال فشل الأمر

إذا تعذّر تنفيذ هذا الأمر، اطلب من مالك المشروع تشغيل الأمر نيابةً عنك، أو منحك دور roles/iam.serviceAccountAdmin على حساب الخدمة من خلال تشغيل:

gcloud iam service-accounts add-iam-policy-binding \
   SERVICE_ACCOUNT \
    --member=USER_EMAIL \
    --role=roles/iam.serviceAccountAdmin \
    --project=PROJECT_ID

إنشاء رمز OAuth مميز قصير الأجل

إذا أردت إعداد annotatePaths باستخدام رمز OAuth مميَّز مع عدم ضبط إعدادات بيئة لإنشاء رموز مميّزة، يمكنك اتّباع الإجراء الوارد في هذا القسم للحصول على رمز OAuth مميز قصير الأجل باستخدام gcloud CLI. (تنتهي صلاحية الرمز المميّز بعد ساعة). لمعرفة مزيد من التفاصيل، يُرجى الاطّلاع على إنشاء بيانات اعتماد قصيرة الأجل لحساب خدمة. الخطوات التالية هي عرض مختصر لهذه التعليمات.

تسجيل الدخول إلى gcloud:
```
gcloud auth login
```
يفتح gcloud نافذة متصفّح ويطلب منك الحصول على إذن.
تحديد مشروعك:
```
gcloud config set project PROJECT_ID
```
احصل على رمز دخول قصير الأجل باستخدام رمز الوصول إلى الطباعة:
```
gcloud auth print-access-token
```
يُرجع هذا الأمر رمزًا مميزًا. انسخ الرمز المميّز وأدرِجه في YOUR_ACCESS_TOKEN باستخدام الأمر التالي:
```
curl -X POST \
https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT:generateAccessToken \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{"scope": ["https://www.googleapis.com/auth/cloud-platform"],"lifetime": "3600s"}'
```
يعرض واجهة سطر الأوامر رمز دخول OAuth قصير الأجل الذي يمكنك استخدامه الآن في تقديم طلبات إلى annotatePaths.

(اختياري) التحقُّق من أذونات رمز OAuth المميز

إذا واجهتك مشاكل في التفويض، يمكنك التحقّق من أذونات رمز OAuth المميز من خلال إدراج الرمز المميّز في عنوان URL التالي، وتخصيص OAUTH_TOKEN. (الصق هذا في شريط العناوين.)

https://oauth2.googleapis.com/tokeninfo?access_token=OAUTH_TOKEN

يجب أن يتضمن الرد نطاق https://www.googleapis.com/auth/cloud-platform. إذا لم يكن كذلك، فتأكد من تعيين النطاق بشكل صحيح كما هو موضح في القسم السابق.

استخدام OAuth في بيئات الإنتاج

للحصول على تعليمات حول استخدام OAuth في بيئة الإنتاج، يمكنك الاطّلاع على المصادقة في Google.

تحديد المشاكل وحلّها

إذا عرض طلبك رسالة خطأ تفيد بأنّ بيانات اعتماد المستخدم غير متوافقة مع واجهة برمجة التطبيقات هذه، يُرجى الاطّلاع على بيانات اعتماد المستخدم لا تعمل.