تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
في هذه الخطوة، يمكنك تحديد حساب على "إعلانات Google" لإجراء طلبات بيانات من واجهة برمجة التطبيقات. يمكن أن يكون الحساب
حسابًا علنيًا (نشطًا) أو حسابًا تجريبيًا. ولكل نهجٍ
مزاياه وعيوبه.
حسابات الإنتاج
الحسابات الاختبارية
الإيجابيات
كتابة واختبار رمز برمجي يعمل مع محتوى محدّد في حسابك بشكل أسهل
كتابة واختبار الرموز البرمجية التي تعالج بيانات إعداد التقارير المباشرة
بسهولة أكبر
لا تعرض الحسابات الاختبارية الإعلانات، وبالتالي لن تؤثّر أخطاء البرمجة
في حملاتك المنشورة.
تعمل مع الرموز المميّزة للمطوّرين التي تمتلك مستوى "الوصول التجريبي".
السلبيات
يمكن أن يؤثّر خطأ في البرمجة في مرحلة التطوير في عرض الإعلانات في الحملة المباشرة، ما يؤدي إلى حدوث مشاكل مثل ضعف أداء الحملة
أو عرض الإعلانات بشكل غير صحيح أو خسائر مالية.
يجب أن يكون لدى رمز المطوِّر مستوى الوصول الأساسي على الأقل للقيام بطلبات البيانات من واجهة برمجة التطبيقات.
يجب إعادة إنشاء الحملات ضمن الحسابات الاختبارية لاختبار الرمز الذي يعمل مع محتوى معيّن للحساب.
بما أنّ الحسابات الاختبارية لا تعرِض الإعلانات، فإنّ الميزات المتعلّقة بالعرض المباشر
غير متاحة، مثل إعداد تقارير الإحصاءات أو أخطاء انتهاك السياسة أو معالجة عمليات استيراد الإحالات الناجحة بلا إنترنت، ما يجعل من الصعب اختبار تلك
الميزات.
ننصحك باستخدام حساب اختبار أثناء تطوير تطبيقك متى كان ذلك ممكنًا. للحصول على التعليمات، يُرجى الاطّلاع على إنشاء حسابات وحملات اختبارية.
يمكنك بدلاً من ذلك إعداد حساب علني بميزانية منخفضة،
مثل دولار أمريكي واحد في اليوم، وذلك لاختبار الميزات التي لا تتيحها
الحسابات التجريبية.
اختيار مجموعة الخصائص
عند اختيار حساب لإجراء طلب بيانات من واجهة برمجة التطبيقات، يجب مراعاة
قائمة الميزات التي تريد استخدامها مع واجهة برمجة التطبيقات. حتى إذا اخترت استخدام
حساب علني، هناك بعض الميزات التي تخصّ الحساب، على سبيل المثال:
لاستخدام ميزات الفوترة، يجب أن يكون لديك حساب يستخدم نظام الفواتير الشهرية.
قد تكون بعض الميزات الجديدة في الحساب محظورة بموجب القوائم المسموح بها.
قبل الانتهاء من إعداد الحساب لإجراء طلبات بيانات من واجهة برمجة التطبيقات، يُرجى الاطّلاع على مستندات الميزة المحدّدة للتأكّد من أنّها لا تفرض قيودًا إضافية.
تحديد رقم تعريف العميل واسم مستخدم تسجيل الدخول
لإجراء طلب بيانات من واجهة برمجة التطبيقات إلى عميل على "إعلانات Google"، يجب منح إذن الوصول و
الأذونات المناسبة لحساب الخدمة إلى حساب العميل
إما مباشرةً أو من خلال حساب إداري مرتبط. لإجراء ذلك، يجب أن يكون لديك
إذن وصول إداري إلى حساب العميل.
ابدأ من خلال تسجيل الدخول إلى حسابك على "إعلانات Google" كمشرف. في بعض الحالات،
قد يكون لديك أكثر من حساب عميل واحد للاختيار من بينها. يُنشئ الحساب الذي
تختاره رقم تعريف العميل لتسجيل الدخول، وهو عنوان مطلوب لبعض
طلبات بيانات من واجهة برمجة التطبيقات.
بعد تحديد عميل "إعلانات Google" الذي تريد إجراء طلبات إليه عبر واجهة برمجة التطبيقات، دوِّن
التفاصيل التالية:
الرقم التعريفي للعميل المكوّن من 10 أرقام لحساب العميل الذي تريد
إجراء طلبات بيانات من واجهة برمجة التطبيقات إليه. ويُشار إلى هذا العميل أحيانًا باسم "العميل المشغّل".
الرقم التعريفي للعميل المكوّن من 10 أرقام لتسجيل الدخول إلى حساب العميل الذي سجّلت الدخول إليه.
إذا كنت مسجِّلاً الدخول إلى حساب العميل المشغّل، يكون الرقم التعريفي للعميل المُستخدَم لتسجيل الدخول هو
نفسه الرقم التعريفي للعميل. إذا سجّلت الدخول إلى حساب إداري للعميل
المشغِّل، يكون رقم تعريف العميل الذي يتم استخدامه لتسجيل الدخول هو رقم تعريف العميل للحساب
الإداري.
منح الإذن بالوصول إلى حساب الخدمة
عندما تكون مسجِّلاً الدخول إلى حسابك على "إعلانات Google" كمشرف، انتقِل إلى
المشرف > الوصول والأمان.
انقر على الزر + ضمن علامة التبويب المستخدمون.
اكتب عنوان البريد الإلكتروني لحساب الخدمة في مربّع الإدخال البريد الإلكتروني. اختَر
مستوى الوصول المناسب إلى الحساب وانقر على الزر إضافة حساب. يُرجى العلم أنّ مستوى الوصول إلى البريد الإلكتروني غير متاح لحسابات الخدمة.
يتم منح حساب الخدمة إذن الوصول.
لا يمكنك بشكلٍ تلقائي منح إذن وصول المشرف إلى حساب الخدمة. إذا كانت
طلبات البيانات من واجهة برمجة التطبيقات تتطلّب إذن وصول المشرف، يمكنك ترقية إذن الوصول على النحو التالي.
انقر على سهم القائمة المنسدلة بجانب مستوى الوصول لحساب الخدمة
في عمود مستوى الوصول.
تاريخ التعديل الأخير: 2025-02-12 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-02-12 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Choose a Google Ads account (production or test) to make API calls, noting its email address for generating OAuth 2.0 refresh tokens."],["Test accounts are recommended for development to prevent affecting live campaigns; however, they don't support features related to live serving."],["Production accounts, with a low budget, can be used to test features unsupported by test accounts, but a programming bug can affect live campaigns."],["Ensure the selected account supports the desired features as some features have account-specific restrictions."],["To make API calls, you need access to the customer account, the 10-digit customer ID, email address for OAuth 2.0 token generation, and the 10-digit login customer ID."]]],[]]