أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
أحد الخيارات المتاحة لإنشاء بيانات اعتماد OAuth2 هو استخدام مساحة بروتوكول OAuth2. تتيح لك "مساحة بروتوكول OAuth2"، بالإضافة إلى وحدة تحكّم Google Ads API، إنشاء رموز مميزة لبروتوكول OAuth2 يدويًا.
تتوفّر أداة OAuth2 Playground للمستخدمين الذين يحتاجون فقط إلى الوصول إلى الحسابات الخاصة بحساب إداري واحد أو مستخدم واحد على "إعلانات Google". إذا كنت بحاجة إلى مطالبة عدة مستخدمين بتقديم بيانات الاعتماد، من الأفضل على الأرجح إعداد مكتبة برامج لبروتوكول OAuth في "إعلانات شبكة البحث 360".
الحصول على معرّف عميل وسر عميل
إذا لم يكن لديك مشروع حالي على السحابة الإلكترونية، اتّبِع الخطوات التالية:
من القائمة المنسدلة الخاصة بالمشروع، اختَر مشروعًا حاليًا أو أنشِئ مشروعًا جديدًا.
في صفحة "بيانات الاعتماد"، انقر على إنشاء بيانات اعتماد، ثم انقر على معرّف عميل OAuth.
ضمن نوع التطبيق، اختَر تطبيق الويب.
ضمن معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، أضِف سطرًا يتضمّن ما يلي:
https://developers.google.com/oauthplayground
انقر على إنشاء.
في صفحة "معرّف العميل"، سجِّل معرّف العميل وسر العميل.
ستحتاج إلى هذه المعلومات في الخطوة التالية.
إذا كان لديك مشروع حالي على السحابة الإلكترونية، يمكنك إعادة استخدامه من خلال ضبط معرّفات الموارد الموحّدة لإعادة التوجيه المصرّح بها كما هو موضّح أعلاه.
إنشاء رموز مميّزة
انتقِل إلى مساحة بروتوكول OAuth2 (سيؤدي استخدام هذا الرابط إلى تعبئة بعض القيم الرئيسية تلقائيًا).
انقر على رمز الترس
في أعلى يسار الصفحة، وضَع علامة في المربّع بجانب استخدام بيانات اعتماد OAuth الخاصة بك (إذا لم يكن المربّع يتضمّن علامة).
تأكَّد مما يلي:
يتم ضبط مسار OAuth على من جهة الخادم.
يتم ضبط نوع الوصول على بلا إنترنت (يضمن ذلك حصولك على رمز مميّز لإعادة التحميل و رمز دخول، بدلاً من رمز دخول فقط).
في القسم الذي يحمل العنوان الخطوة 1 - اختيار واجهات برمجة التطبيقات ومنح الإذن بالوصول إليها، انقر على Search Ads 360 Reporting API من القائمة واختَر نطاقها،
https://www.googleapis.com/auth/doubleclicksearch. بعد ذلك، انقر على تفويض واجهات برمجة التطبيقات:
إذا طُلب منك ذلك، سجِّل الدخول إلى الحساب الذي تريد منح الإذن بالوصول إليه. بخلاف ذلك، تأكَّد من أنّ المستخدم الحالي في أعلى يسار الصفحة هو حساب العميل أو الحساب الإداري الذي تريد الحصول على بيانات الاعتماد الخاصة به.
ستظهر رسالة تطلب منك السماح للتطبيق بإدارة حملاتك على "إعلانات شبكة البحث 360". انقر على قبول للمتابعة.
في علامة التبويب التي تحمل اسم الخطوة 2 - تبديل رمز التفويض بالرموز المميزة، من المفترض أن يظهر رمز التفويض. انقر على
Exchange authorization code for tokens (تبديل رمز التفويض بالرموز المميّزة).
إذا سارت الأمور على ما يرام، من المفترض أن يتم ملء رمز التحديث ورمز الدخول نيابةً عنك (قد تحتاج إلى إعادة توسيع الخطوة 2 - تبديل رمز التفويض بالرموز المميزة):
انسخ رمز التحديث إلى ملف الإعداد الخاص بمكتبة العميل التي تختارها، بالإضافة إلى معرّف العميل وسر العميل.
بعد الحصول على رمز مميز لإعادة التحميل، لن تحتاج إلى OAuth2 Playground ليكون معرّف موارد منتظمًا (URI) معتمَدًا لإعادة التوجيه. لإزالته من قائمة معرّفات الموارد المنتظمة (URI) المسموح بإعادة التوجيه إليها، اتّبِع الخطوات التالية:
في صفحة "بيانات الاعتماد"، انقر على اسم معرّف العميل لتعديله.
أزِل https://developers.google.com/oauthplayground من معرّفات الموارد المنتظمة (URI) المسموح بإعادة التوجيه إليها. يُرجى العِلم أنّه يجب ترك معرّف موارد منتظم واحد لإعادة التوجيه على الأقل.
تاريخ التعديل الأخير: 2025-09-03 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-03 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe OAuth2 Playground enables manual creation of OAuth2 tokens for single manager account or Google Ads user access.\u003c/p\u003e\n"],["\u003cp\u003eTo use the OAuth2 Playground, you need a client ID and client secret generated for a web application in the Google API Console.\u003c/p\u003e\n"],["\u003cp\u003eGenerate refresh and access tokens using the OAuth2 Playground by authorizing the Search Ads 360 Reporting API.\u003c/p\u003e\n"],["\u003cp\u003eConfigure your client library using the generated refresh token, client ID, and client secret for Search Ads 360 API access.\u003c/p\u003e\n"],["\u003cp\u003eAfter obtaining the refresh token, remove the OAuth2 Playground from the authorized redirect URIs in your Google API Console project.\u003c/p\u003e\n"]]],["To generate OAuth2 credentials via the OAuth2 Playground, first create a web application client ID and secret in the Google API Console, adding `https://developers.google.com/oauthplayground` as an authorized redirect URI. Next, navigate to the OAuth2 Playground, input your credentials, and select the Search Ads 360 Reporting API scope. Authorize the API, exchange the authorization code for tokens, and copy the refresh token, client ID, and client secret to your client library configuration. Finally, remove the OAuth2 Playground URI from your authorized redirect URIs.\n"],null,[]]
في أعلى يسار الصفحة، وضَع علامة في المربّع بجانب استخدام بيانات اعتماد OAuth الخاصة بك (إذا لم يكن المربّع يتضمّن علامة).
