التفويض

تستخدم Checks API بروتوكول OAuth 2.0 للسماح بالطلبات.

نطاق OAuth هو https://www.googleapis.com/auth/checks.

الموافقة باستخدام OAuth 2.0

يوضّح لك دليل البدء السريع هذا كيفية تفويض الطلبات باستخدام حساب خدمة من خلال واجهة سطر الأوامر gcloud.

إعداد gcloud CLI

1. ثبِّت gcloud CLI.

2. سجِّل الدخول باستخدام gcloud CLI واضبط مشروعًا تلقائيًا:

   gcloud auth login
   gcloud config set project PROJECT_ID

3. أنشئ حساب خدمة ومفتاح حساب خدمة، وأعِد إعداد بيانات الاعتماد التلقائية للتطبيق:

   gcloud iam service-accounts create SA_NAME
   gcloud iam service-accounts keys create key.json \
       --iam-account=SA_NAME@PROJECT_ID.iam.gserviceaccount.com
   export GOOGLE_APPLICATION_CREDENTIALS=key.json

منح إذن الوصول إلى واجهة برمجة التطبيقات لحسابك على "الشيكات"

يجب أن يكون مستخدمو واجهة برمجة التطبيقات من مستخدمي حسابك على Checks وأن يكون لديهم أذونات القراءة أو الكتابة المناسبة.

1. انتقِل إلى صفحة الإعدادات في Checks Console وانقر على إدارة المستخدمين.

2. أرسِل دعوة إلى حساب الخدمة الذي أنشأته سابقًا:

   SA_NAME@PROJECT_ID.iam.gserviceaccount.com
   

العثور على رقم تعريف حسابك

رقم تعريف حساب الشيكات هو معرّف المورد لطلبات موارد الحساب.

على سبيل المثال، تتضمّن طريقة accounts.apps.list التي تعرض تطبيقاتك التنسيق التالي:

https://checks.googleapis.com/v1alpha/accounts/ACCOUNT_ID/apps

يمكنك العثور على رقم تعريف حسابك في صفحة الإعدادات ضمن قسم معلومات الحساب في Checks Console.

الحصول على رمز الدخول

gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/checks

تقديم طلب

curl -X GET \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/checks)" \
    "https://checks.googleapis.com/v1alpha/accounts/ACCOUNT_ID/apps"