مسار حساب خدمة OAuth

سيرشدك هذا الدليل إلى كيفية إعداد بروتوكول OAuth 2 للوصول إلى واجهة برمجة التطبيقات باستخدام بيانات الاعتماد الخاصة بك باستخدام حسابات الخدمة. يجب تنفيذ هذه الخطوات مرة واحدة فقط، ما لم تلغي بيانات اعتماد OAuth2 أو تحذفها.

إنشاء بيانات اعتماد OAuth2

ملاحظة: تتطلّب هذه العملية استخدام نطاق Google Workspace، ويجب أن يمنح مشرف متميز للنطاق حساب الخدمة الذي أنشأته إذن الوصول المفوَّض على مستوى النطاق.

أنشئ رقم تعريف حساب خدمة (مفوَّض) وملف *.JSON باتّباع التعليمات المرتبطة، ثم ارجع إلى هذه الصفحة.

إعداد مكتبة البرامج

اضبط مسار ملف JSON للمفتاح الخاص ومعرّف الحساب المفوَّض فيملف الإعدادات. إذا كنت تستخدم ملف googleads.properties، أضِف ما يلي:

jsonKeyFilePath=PRIVATE_KEY_FILE_PATH
impersonatedEmail=DELEGATE_ACCOUNT

إذا كنت تستخدم متغيّرات البيئة، أضِف ما يلي إلى إعدادات Bash أو بيئته:

export GOOGLE_ADS_JSON_KEY_FILE_PATH=PRIVATE_KEY_FILE_PATH
export GOOGLE_ADS_IMPERSONATED_EMAIL=DELEGATE_ACCOUNT_ID

ملاحظة مهمة: عند تحميل الإعدادات، تبحث المكتبة أولاً عن بيانات الاعتماد من عمليات OAuth2 على الكمبيوتر المكتبي أو تطبيقات الويب، ثم تستخدمها في حال العثور عليها. لذلك، إذا أردت استخدام مصادقة حساب الخدمة، تأكَّد من أنّ بيانات اعتماد عمليات الإعداد الأخرى غير متوفّرة في الإعدادات.