يلخّص الجدول التالي بيانات الاعتماد التي يجب أن يديرها التطبيق. لمزيد من المعلومات حول أنواع التطبيقات، يُرجى الاطّلاع على مستندات Google Identity OAuth 2.0.
| سير عمل المصادقة | بيانات الاعتماد | نوع بيانات الاعتماد | الغرض |
|---|---|---|---|
|
تطبيقات الويب المستندة إلى JavaScript تطبيقات Android |
معرِّف عميل OAuth | بيانات اعتماد التطبيق | يحدِّد التطبيق بشكل فريد أثناء عملية OAuth. |
| رمز الدخول والرمز المميّز لإعادة التحميل | بيانات اعتماد المستخدم | يمثّل هذا الإذن تفويض المستخدم للسماح للتطبيق بالوصول إلى حسابه على "إعلانات Google" نيابةً عنه. | |
|
تطبيقات الويب من جهة الخادم تطبيقات الكمبيوتر وiOS تطبيقات التلفزيون والأجهزة |
معرِّف عميل OAuth وسر العميل | بيانات اعتماد التطبيق | يحدِّد التطبيق بشكل فريد أثناء عملية OAuth. |
| رمز الدخول والرمز المميّز لإعادة التحميل | بيانات اعتماد المستخدم | يمثّل تفويض المستخدم للسماح للتطبيق بالوصول إلى حسابه على "إعلانات Google" نيابةً عنه. | |
| حسابات الخدمة | مفتاح حساب خدمة OAuth | بيانات اعتماد التطبيق | يُستخدَم لتوقيع طلب OAuth. |
| رمز الدخول إلى حساب الخدمة | بيانات اعتماد المستخدم | يمثّل تفويض حساب الخدمة عندما يشارك مستخدم حسابه على "إعلانات Google" مع حساب الخدمة. |
هناك عدة نقاط يجب مراعاتها عند إدارة بيانات الاعتماد لتطبيق Google Ads API.
التعامل مع بيانات اعتماد التطبيق بأمان
تشير بيانات اعتماد التطبيق إلى الإعدادات الخاصة بتطبيقك والتي لا تختلف من مستخدم لآخر. يجب التعامل مع بيانات اعتماد تطبيق OAuth بحذر شديد، لأنّها تسمح لأي شخص يملكها باستخدام هوية تطبيقك للوصول إلى معلومات المستخدمين. يُرجى تخزين بيانات اعتماد تطبيق OAuth في مكان آمن وحمايتها، تمامًا كما تفعل مع كلمة المرور. استخدِم مدير مفاتيح سرية، مثل Google Cloud Secret Manager، لتخزين بيانات اعتماد التطبيق حيثما أمكن. يجب عدم تضمين بيانات اعتماد العميل في مستودعات الرموز البرمجية المتاحة للجميع. ننصحك بشدة بتجنُّب إضافتها إلى أي مستودع رموز برمجية.
التعامل مع بيانات اعتماد المستخدمين بأمان
تشير بيانات اعتماد المستخدم إلى رموز OAuth المميّزة التي تمثّل تفويض المستخدم. ويعهد بها إليك المستخدمون الذين يمنحونك الإذن باتخاذ إجراءات والوصول إلى البيانات نيابةً عنهم، إما مباشرةً من خلال مصادقة تطبيقك أو بشكل غير مباشر من خلال مشاركة حسابهم على "إعلانات Google" مع حساب الخدمة الخاص بك. لا تنقل الرموز المميزة بنص عادي أبدًا، وخزِّن دائمًا الرموز المميزة المشفّرة في حالة عدم النشاط لتوفير طبقة حماية إضافية في حال اختراق البيانات. يمكنك إبطال الرموز المميّزة أو أذونات حساب الخدمة عندما لا تحتاج إلى الوصول إلى حساب المستخدم. بعد إبطال الرموز المميّزة، احذفها نهائيًا من تطبيقك أو نظامك.
التعامل مع إبطال الرمز المميّز لإعادة التحميل وانتهاء صلاحيته
إذا كنت تستخدم مسار مصادقة المستخدم، يُرجى العِلم أنّه يمكن إبطال الرموز المميّزة لإعادة التحميل في أي وقت. على سبيل المثال، إذا كنت تستخدم مسار مصادقة متعدد المستخدمين، يمكن للمستخدم اختيار إبطال إمكانية الوصول إلى تطبيقك. ومع أنّ التطبيق الذي يستخدم مسار مصادقة مستخدم واحد أقل عرضة للتأثر بهذه الطريقة، فإنّ العملية اليدوية أو الآلية المصممة لحماية المستخدمين قد تؤدي إلى إزالة الرمز المميز لإعادة التحميل، أو قد تنتهي صلاحية الرمز المميز لإعادة التحميل. إذا كان تطبيقك يتطلّب إشعارًا بإبطال الرمز المميّز لتقديم تجربة جيدة للمستخدمين، عليك الدمج مع خدمة الحماية العابرة للحساب.
إعادة استخدام بيانات اعتماد المستخدم في طلبات البيانات من واجهة برمجة التطبيقات
تكون رموز الدخول عبر OAuth قصيرة الأجل وتنتهي صلاحيتها بعد ساعة واحدة. إذا كنت تستخدم مكتبة عملاء Google Ads API، ستتولى المكتبة معالجة انتهاء صلاحية رمز الوصول وإعادة تحميله بطريقة آمنة لسلسلة التعليمات. أنشئ عنصر عميل Google Ads API باستخدام بيانات اعتماد OAuth المناسبة وأعِد استخدامه طوال مدة صلاحيته.
إذا أنشأت استراتيجية خاصة بك لإدارة رموز الوصول وإعادة تحميلها، تتبَّع انتهاء صلاحية رموز الوصول وأعِد استخدامها طالما أنّها صالحة. عند طلب إعادة تحميل الرمز المميّز، يعرض خادم التفويض رمز دخول جديدًا مع المدة المتبقية بالثواني (expires_in). ننصحك بإعادة تحميل رمز الدخول بشكل استباقي إذا كان هناك أقل من 5 دقائق متبقية قبل انتهاء الصلاحية.