التحقّق بخطوتين
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتيح إذن "إعلانات Google" تفعيل ميزة التحقّق بخطوتين في حسابك على "إعلانات Google". يعرض الجدول التالي السيناريوهات الثلاثة لتفعيل ميزة "التحقّق بخطوتين".
يُفعّل المستخدم ميزة "التحقّق بخطوتين" في حسابه على Google
|
قد يقرّر المستخدم من تلقاء نفسه تفعيل ميزة "التحقّق بخطوتين" في حسابه على Google.
بعد تفعيل ميزة "التحقّق بخطوتين"
أثناء
عملية مصادقة OAuth2،
تطلب Google من المستخدم إكمال عملية التحقّق بخطوتين قبل إصدار رمز مميّز لإعادة التحقّق.
بعد إصدار رمز إعادة التحميل، يمكن استخدامه لإنشاء رمز الدخول المميز المطلوب في طلبات البيانات من واجهة برمجة التطبيقات.
رموز إعادة التحميل السابقة
يظل رمز التحديث الذي تم إصداره قبل أن يفعّل المستخدم ميزة "التحقّق بخطوتين" صالحًا بعد أن يفعّل المستخدم هذه الميزة. ويمكن استخدام رمز التحديث لإصدار رموز دخول صالحة كالمعتاد.
|
يشترط المشرف على مستخدمي حساب "إعلانات Google" تفعيل ميزة "التحقّق بخطوتين" في حساباتهم على Google
|
يمكن أن يشترط مشرف الحساب أن يُفعّل جميع مستخدمي حساب على "إعلانات Google" ميزة
التحقّق بخطوتين
في حساباتهم على Google.
تفعيل ميزة "التحقّق بخطوتين" من قِبل المستخدم
أثناء
عملية مصادقة OAuth2،
تطلب Google من المستخدم إكمال عملية التحقّق بخطوتين قبل إصدار رمز مميّز لإعادة التحقّق.
بعد إصدار رمز إعادة التحميل، يمكن استخدامه لإنشاء رمز الدخول المميز المطلوب في طلبات البيانات من واجهة برمجة التطبيقات.
لم يفعّل المستخدم ميزة "التحقّق بخطوتين"
أثناء عملية المصادقة، لن يظهر للمستخدم طلب التحقّق بخطوتين. ولا ترتبط هذه التجربة بأي إعدادات في حساب Google Ads.
بعد إصدار الرمز المميز لإعادة التحميل، يمكن استخدامه لإصدار رموز الدخول. ومع ذلك، ستتعذّر طلبات البيانات من واجهة برمجة التطبيقات التي يتم إجراؤها باستخدام رمز الدخول هذا، وسيظهر الخطأ
TWO_STEP_VERIFICATION_NOT_ENROLLED إلى أن يفعّل المستخدم ميزة "التحقّق بخطوتين" في حسابه على Google.
رموز إعادة التحميل السابقة
تنطبق هذه القاعدة أيضًا على رموز التحديث المميزة الصادرة قبل فرض شرط استخدام ميزة "التحقّق بخطوتين"، إذ يمكن استخدام رمز التحديث المميز لإنشاء رموز مميزة للوصول، ولكن ستتعذّر طلبات البيانات من واجهة برمجة التطبيقات التي يتم إجراؤها باستخدام رموز الوصول المميزة هذه وسيظهر الخطأ
TWO_STEP_VERIFICATION_NOT_ENROLLED إلى أن يفعّل المستخدم ميزة "التحقّق بخطوتين" في حسابه على Google.
|
تطلب Google من جميع مستخدمي حساب "إعلانات Google" تفعيل ميزة "التحقّق بخطوتين" في حساباتهم على Google {:#require-2-step}
|
في بعض الحالات، قد تطلب Google من جميع مستخدمي حساب "إعلانات Google" تفعيل ميزة
التحقّق بخطوتين في حساباتهم على Google.
بعد تفعيل ميزة "التحقّق بخطوتين"
أثناء عملية مصادقة OAuth2، تطلب Google من المستخدم إكمال عملية التحقّق بخطوتين قبل إصدار رمز مميّز لإعادة التحقّق.
لا تتأثر هذه التجربة بما إذا كان حساب "إعلانات Google" قد فعّل ميزة التحقّق بخطوتين لجميع مستخدميه.
بعد إصدار رمز التحديث، يمكن استخدامه لإنشاء رمز الدخول
المطلوب في طلبات البيانات من واجهة برمجة التطبيقات كالمعتاد.
رموز إعادة التحميل السابقة
يظل رمز التحديث الذي تم إصداره قبل أن يفعّل المستخدم ميزة "التحقّق بخطوتين" صالحًا بعد أن يفعّل المستخدم هذه الميزة. ويمكن استخدام الرمز المميز لإعادة التحميل
لإنشاء رمز دخول صالح كالمعتاد.
لن تواجه طلبات البيانات من واجهة برمجة التطبيقات التي يتم إجراؤها باستخدام رمز الدخول هذا الخطأ TWO_STEP_VERIFICATION_NOT_ENROLLED لأنّ Google هي التي بدأت عملية تفعيل ميزة "التحقّق بخطوتين" وليس مشرف حساب "إعلانات Google".
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle Ads authorization supports enabling 2-Step Verification for enhanced security, impacting how refresh and access tokens function.\u003c/p\u003e\n"],["\u003cp\u003eUsers voluntarily enabling 2-Step Verification or being required to by administrators or Google will encounter a 2-Step Verification prompt during authentication.\u003c/p\u003e\n"],["\u003cp\u003eIf an administrator requires 2-Step Verification, API calls will fail with an error until it's enabled, even with existing refresh tokens.\u003c/p\u003e\n"],["\u003cp\u003eRefresh tokens issued before enabling 2-Step Verification generally remain valid but may be subject to the specific scenario and enforcement level.\u003c/p\u003e\n"],["\u003cp\u003eGoogle enforcing 2-Step Verification differs from administrator enforcement, as API calls with existing refresh tokens won't encounter the \u003ccode\u003eTWO_STEP_VERIFICATION_NOT_ENROLLED\u003c/code\u003e error.\u003c/p\u003e\n"]]],[],null,["# 2-Step Verification\n\nGoogle Ads authorization supports enabling [2-Step Verification on your Google Ads\naccount](//support.google.com/google-ads/answer/12864186). The following table\npresents the three scenarios for enabling 2-Step Verification.\n\n|-----------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### User turns on 2-Step Verification on their own Google Account | *A user might decide on their own to turn on 2-Step Verification for their Google Account.* #### After 2-Step Verification is enabled During the [OAuth2 authentication flow](/google-ads/api/docs/oauth/client-library), Google prompts the user for 2-Step Verification before issuing a refresh token. Once issued, the refresh token can be used to generate the access token needed in API calls. #### Previous refresh tokens A refresh token that was issued before the user enabled 2-Step Verification remains valid after the user enables 2-Step Verification. The refresh token can be used to issue valid access tokens as usual. |\n| ### Administrator requires users of a Google Ads account to enable 2-Step Verification on their Google Account | *An account administrator can require all users of a Google Ads account to [enable 2-Step Verification](https://support.google.com/google-ads/answer/12865295) on their Google Account.* #### User enables 2-Step Verification During the [OAuth2 authentication flow](/google-ads/api/docs/oauth/client-library), Google prompts the user for 2-Step Verification before issuing a refresh token. Once issued, the refresh token can be used to generate the access token needed in API calls. #### User doesn't enable 2-Step Verification During the authentication flow, the user won't see the 2-Step Verification prompt. This experience is independent of any settings on the Google Ads account. Once issued, the refresh token can be used to issue access tokens. However, the API calls made using this access token will fail with a [`TWO_STEP_VERIFICATION_NOT_ENROLLED`](/google-ads/api/reference/rpc/v21/AuthenticationErrorEnum.AuthenticationError#two_step_verification_not_enrolled) error until the user enables 2-Step Verification in their Google Account. ##### Previous refresh tokens This rule applies to refresh tokens issued prior to the 2-Step Verification requirement as well---the refresh token can be used to generate access tokens, but API calls made with these access tokens will fail with a [`TWO_STEP_VERIFICATION_NOT_ENROLLED`](/google-ads/api/reference/rpc/v21/AuthenticationErrorEnum.AuthenticationError#two_step_verification_not_enrolled) error until the user enables 2-Step Verification in their Google Account. |\n| ### Google requires all users of a Google Ads account to opt in to 2-step verification on their Google Account {:#require-2-step} | *In some cases, Google might require all users of a Google Ads account to enable 2-step verification on their Google Account.* #### After 2-Step Verification is enabled During the [OAuth2 authentication flow](/google-ads/api/docs/oauth/client-library), Google prompts the user for 2-Step Verification before issuing a refresh token. This experience is independent of whether Google opted in the Google Ads account to require all its users to enable 2-factor verification. Once issued, the refresh token can be used to generate the access token needed in API calls as usual. #### Previous refresh tokens A refresh token that was issued before the user enabled 2-Step Verification remains valid after the user enables 2-Step Verification. The refresh token can be used to issue a valid access token as usual. API calls made using this access token won't encounter the `TWO_STEP_VERIFICATION_NOT_ENROLLED` error because the 2-Step Verification opt-in was initiated by Google and not by the Google Ads account administrator. |"]]
