قائمة تحقق المبتدئين في إعلانات Google

سترشدك قائمة التحقّق هذه خلال عملية بدء استخدام Google Ads API. تم تقسيم الخطوات إلى عدة فئات، ويمكنك تخطّي بعض منها إذا لم تكن مناسبة لاحتياجاتك. للاستفادة إلى أقصى حد من هذا المستند، يُرجى قراءة الخطوات وتنفيذها بالترتيب.

تحتوي القائمة على ثلاثة أنواع من العناصر:

	المهام: الخطوات المطلوبة لتنفيذ مهمة معيّنة أو إعداد جزء معيّن من أداتك
	معلومات: معلومات ليست ضرورية للعملية، ولكنها ستساعدك في فهم السياق أو توضيح خطوات معيّنة.
	تحذير: يشير هذا الرمز إلى النقاط التي يجب الانتباه إليها أثناء التنفيذ، لأنّها قد تتطلّب مجهودًا إضافيًا أو تؤدي إلى مخاطر معيّنة .

إذا كنت بصدد طباعة قائمة التحقّق، يمكنك استخدام مربّعات الاختيار على اليمين لتحديد الخطوات التي تم إكمالها. تقدّم قائمة التحقّق هذه ترتيبًا مقترَحًا للقراءة للمعلومات الواردة في مستندات Google Ads API.

الوصول والإعداد

	احصل على رمز المطوِّر من API Center في حسابك الإداري على المستوى الأعلى. يجب إكمال جميع الحقول في نموذج الوصول إلى واجهة برمجة التطبيقات، ويجب قبول الأحكام والشروط. تأكَّد من أنّ عنوان البريد الإلكتروني المخصّص للتواصل بشأن واجهة برمجة التطبيقات الذي تقدّمه يؤدي إلى صندوق بريد وارد تتم مراقبته بانتظام. سيتم منحك رمزًا مميزًا للمطوّر يتضمن مستوى الوصول إلى الحساب التجريبي.
	هذا كل ما تحتاجه لتجربة Google Ads API باستخدام الحسابات الاختبارية. يمكنك استخدام الحسابات الاختبارية لإنشاء الحملات والإعلانات، ولكن لن يتم عرض أيّ من إعلاناتك فعليًا (ولن تتراكم التكاليف) وستكون جميع الإحصاءات في التقارير 0. لمنح الرمز المميَّز للمطوِّر إذن الوصول إلى حسابات الإصدار العلني، يجب أن يوافق عليه فريق مراجعة الرموز المميَّزة.
	للحصول على موافقة على الرمز المميّز للوصول إلى قناة الإصدار العلني، عليك ملء نموذج طلب المتابعة وشرح كيفية استخدامك لواجهة برمجة التطبيقات. وعليك أيضًا تقديم مستند تصميم. يمكنك استخدام قالب لبدء إنشاء الفيديو. يُرجى تقديم أكبر قدر ممكن من التفاصيل. سيتواصل معك فريق مراجعة الرموز المميّزة إذا احتاج إلى مزيد من المعلومات، ولكن يمكنك أيضًا التواصل معنا من خلال نموذج التواصل إذا لم يصلك أيّ ردّ في غضون يومَي عمل.
	بعد الموافقة على رمز ميزات المطوّر، يمكنك استخدامه لإجراء طلبات بيانات من واجهة برمجة التطبيقات إلى حسابات الإصدار العلني. في البداية، سيتم منحك إذن استخدام أساسي، والذي يسمح بإجراء 15,000 عملية في اليوم والحد الأقصى 1,000 عملية get في اليوم.
	إذا تم رفض طلبك، ستصلك رسالة إلكترونية توضّح الأسباب. يمكنك إجراء تغييرات على طلبك وتقديم مزيد من التفاصيل حول الحلّ وإعادة تقديم الطلب.

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

	نستخدم OAuth 2.0 لمصادقة طلباتك على واجهة برمجة التطبيقات. اتّبِع التعليمات الواردة في دليل OAuth 2.0 لإعداد بيانات الاعتماد لبروتوكول OAuth 2.0. يمكنك استخدام مساحة OAuth 2.0 لتحديد المشاكل وحلّها.
	نوفّر مكتبات عملاء لبعض لغات البرمجة الشائعة. نزِّل المكتبة للّغة التي تريد استخدامها وإعداد ملف الإعدادات باستخدام بيانات الاعتماد التي حصلت عليها سابقًا.

الرمز المميّز للمطوّر - مستويات الوصول

	اطّلِع على مستويات الوصول، وحدِّد ما إذا كانت أداتك ستتطلّب أكثر من 15,000 عملية في اليوم في وقت ما في المستقبل. إذا كان الأمر كذلك، عليك تقديم طلب للحصول على إذن بالوصول العادي لإجراء عدد غير محدود من عمليات mutate وطلبات GoogleAdsService.Search وGoogleAdsService.SearchStream يوميًا. ومع ذلك، يبقى هذا الإجراء تابعًا للحدّ الأقصى اليومي البالغ 1,000 عملية جلب.
	راجِع جدول الأسعار لفهم كيفية احتساب العمليات لمستوى وصولك. يُرجى العلم أنّه لا يتم احتساب طلبات GoogleAdsService.Search التي تم ضبط الحقل page_token فيها ضمن الحد الأقصى المسموح به لعدد العمليات.

الحد الأدنى المطلوب من الوظائف

	اطّلِع على الحدّ الأدنى المطلوب من الوظائف (RMF)، وهي مجموعة من الوظائف التي يجب أن تنفّذها أداتك استنادًا إلى طبيعة الأداة.
	إنّ الأدوات التي يمكنها العمل باستخدام "الوصول الأساسي"، أي أقل من 15,000 طلب في اليوم، معفاة من "إدارة المخاطر وعمليات الموافقة". إنّ الأدوات التي لا يمكن للمعلِنين الوصول إليها والمخصّصة للاستخدام الداخلي فقط معفاة من "إدارة الموافقة". إذا كانت الأداة لا تُعدّ سوى التقارير، سيتم تطبيق نموذج إعداد التقارير فقط. إذا كانت أداتك محدودة للغاية ومتخصّصة، مثل Shopping أو "الإعلانات الترويجية للتطبيقات" فقط، لن ينطبق سوى الجزء من إطار عمل معالجة البيانات الذي تستخدمه أداتك. إذا لم تكن متأكدًا من أنّ سياسة "الحد الأدنى المطلوب من الوظائف" تنطبق على أداتك، يُرجى التواصل مع فريق الامتثال الخاص بواجهة Google Ads API.
	اطّلِع على رسوم عدم الامتثال لفهم ما يحدث عند عدم تنفيذ آليات إدارة المخاطر بشكل صحيح.
	إذا كانت الأداة مخصّصة للاستخدام خارج مؤسستك (بمعنى آخر، إنّها ليست أداة داخلية فقط)، يجب أن تطبّق تدابير إدارة المخاطر المتعلّقة بالأفراد قبل تقديم طلب للحصول على إذن الوصول العادي. تذكَّر أنّ نموذج إدارة المخاطر يخضع للتغييرات التي تطرأ على واجهة برمجة التطبيقات. إذا قرّرت تقديم طلب للحصول على إذن الوصول العادي، عليك إبقاء أداتك محدّثة باستخدام أحدث إصدار من "الحد الأدنى المطلوب من الوظائف".
	تأكَّد من أنّ أداتك تنفِّذ آليات إدارة المخاطر السارية.
	قدِّم طلبًا للحصول على إذن بالوصول العادي.

بدء العمل مع واجهة برمجة التطبيقات

	اطّلِع على مقالة إجراء طلبك الأول لواجهة برمجة التطبيقات التي توضّح كيفية الحصول على الحملات باستخدام واجهة برمجة التطبيقات. يمكن الوصول إلى جميع الكائنات بطريقة مشابهة، لذا من المفيد حفظ البنية.
	فهم أساسيات بنية واجهة برمجة التطبيقات للموارد والخدمات
	اطّلِع على مقالتَي تغيير العناصر وفحصها واسترداد العناصر.
	اطّلِع على البيانات الوصفية للموارد لفهم كيفية طلبها ديناميكيًا.
	اطّلِع على نظرة عامة على الحملات لإنشاء أنواع مختلفة من الحملات والإعلانات وإدارتها.

أمثلة على الرموز البرمجية

	اطّلِع على عيّنة الرمز البرمجي ونفِّذها للتعرّف على كيفية استخدام واجهة برمجة التطبيقات. ننصحك بتنفيذ المثالَين التاليَين على الأقلّ لفهم كيفية إدارة عناصر "إعلانات Google" الأساسية.
	العمليات الأساسية > الحصول على الحملات
	العمليات الأساسية > الحصول على إعلانات نصية موسّعة
	العمليات الأساسية > إضافة حملات
	العمليات الأساسية > إضافة كلمات رئيسية
	العمليات الأساسية > تعديل الكلمة الرئيسية
	إدارة الحملات > الحصول على كل الإعلانات المرفوضة
	إدارة الحملات > إضافة مُعدِّل عروض أسعار الحملة
	إدارة الحساب > الحصول على معلومات الحساب
	إدارة الحساب > إنشاء عميل
	إدارة الحساب > تلقّي تغييرات الحساب

إعداد التقارير

	لإعداد التقارير، ستحتاج إلى استخدام حساب يعرض الإعلانات لفترة زمنية كافية لإنشاء مقاييس الأداء (ننصح باستخدام حساب لمدة 7 أيام على الأقل).
	اطّلِع على نظرة عامة سريعة على إعداد التقارير، ومثال لتلخيص أداء حساب خلال آخر 30 يومًا باستخدام GoogleAdsService بصفتها المصدر الوحيد للمعلومات في إعداد التقارير في "إعلانات Google".
	اطّلِع على لغة طلبات البحث في "إعلانات Google" (GAQL) لفهم قواعد طلبات البحث وبنيتها ومفاهيم الموارد والشرائح والمقاييس.
	اطّلِع على مزيد من المعلومات حول مقاييس المعايير لفهم كيفية استرداد بيانات الأداء لمعايير مختلفة باستخدام *_view الموارد، على سبيل المثال، KeywordView TopicView وGenderView.

أداة إنشاء الطلبات التفاعلية في "إعلانات Google"

	استكشِف الميزات المتاحة في أداة المطوّرين أداة إنشاء طلبات البحث التفاعلية في "إعلانات Google". تعثر هذه الأداة المستندة إلى الويب على جميع الحقول والفلاتر المتوفّرة للمورد المحدّد، وتُنشئ طلبات البحث بطريقة تفاعلية.
	استخدِم المحرِّر في هذه الأداة لإنشاء عبارة بلغة طلبات البحث في "إعلانات Google" لمورد معيّن، مثل مجموعة إعلانية. انسخ عبارة GAQL التي تم إنشاؤها والصقها في تطبيقك.

أبحاث الكلمة الرئيسية

إذا لم تكن على دراية بأداة تخطيط الكلمات الرئيسية، جرِّبها للاطّلاع على آلية عمل ميزة تخطيط الكلمات الرئيسية في واجهة مستخدم "إعلانات Google".

توفّر Google Ads API عدّة خدمات تعكس وظائف "أداة تخطيط الكلمات الرئيسية" وتساعدك في البحث عن الكلمات الرئيسية. تقترح KeywordPlanIdeaService أفكارًا للكلمات الرئيسية استنادًا إلى مَعلمات معيّنة، وتقدّم KeywordPlanService إحصاءات مقدَّرة عن أداء الكلمات الرئيسية وتساعدك في تقييم نوعيتها. ننصحك بشدة باستخدام حساب على "إعلانات Google" يتضمّن حملات نشطة لإصدار طلبات البيانات هذه من واجهة برمجة التطبيقات للحصول على مقاييس دقيقة.

أمثلة على الرموز البرمجية

	يمكنك التعرّف على وظائف تخطيط الكلمات الرئيسية من خلال تشغيل نماذج الرموز البرمجية أدناه.
	عيّنات التخطيط -> إنشاء مقاييس التوقّعات
	عيّنات التخطيط -> إنشاء أفكار للكلمات الرئيسية

إعداد الميزانيات تلقائيًا

	اطّلِع على إعدادات methods والدفع للتعرّف على خيارات الفوترة المتاحة في "إعلانات Google"، مثل الدفعات التلقائية والدفعات اليدوية والفوترة الشهرية (حد الائتمان).
	إذا كنت لا تستخدم نظام الفواتير الشهرية ولا تخطّط للتسجيل فيه، يمكنك تخطّي هذا القسم.
	اطّلِع على إعداد الفوترة للتعرّف على كيفية إدارة ملفات الدفع وحسابات الدفع آليًا.
	اطّلِع على مزيد من المعلومات عن ميزانية الحساب لفهم كيفية تخصيص الميزانيات تلقائيًا للحسابات.
	يتطلّب استخدام AccountBudgetProposalService إدراج حسابك الإداري على "إعلانات Google" في القائمة المسموح بها لهذا الغرض. لن تتمكّن من استخدام هذه الخدمة إلى أن تكتمل هذه العملية. ستحتاج أيضًا إلى إعداد نظام الفواتير الشهرية مع Google. يُرجى التواصل مع مدير الشركاء الإستراتيجيين (SPM) في Google لترتيب هذه العملية. لا يمكن الوصول إلى هذه الميزة إلا لشركاء Google.
	تواصَل مع ممثل نشاطك التجاري في Google لتقديم طلب للاشتراك في ميزة الفوترة الشهرية.
	يُرجى التواصل مع ممثّل نشاطك التجاري في Google لطلب الوصول إلى AccountBudgetProposalService.
	أنشئ AccountBudgetProposal وحدِّده لحساب. جرِّب استخدام الميزانية مع ميزانية حملة.

إعلانات Shopping

	إذا كنت تريد استخدام إعلانات Shopping، من المحتمل أن تحتاج إلى استخدام Google Merchant Center وContent API for Shopping لإدارة بيانات المنتجات. يصف هذا القسم الخطوات الأساسية للبدء باستخدام واجهة برمجة التطبيقات هذه.
	إعداد حساب على Merchant Center و الحصول على MerchantID
	احصل على مفتاح حساب الخدمة إذا كان تطبيقك يحتاج فقط إلى الوصول إلى حسابك على Merchant Center. ولكن إذا كنت بصدد كتابة تطبيق تابع لجهة خارجية يحتاج إلى الوصول إلى حسابات Merchant Center الخاصة بعملاءك، راجِع دليل منح الأذونات باستخدام OAuth 2.0.
	نزِّل مكتبة برامج العميل للّغة التي تختارها.
	يمكنك الاطّلاع على أمثلة الرموز البرمجية لواجهة Content API بلغات برمجة مختلفة، مثل Java و ‎.NET و PHP و Python وغيرها.
	تعرَّف على كيفية الربط اليدوي لحسابَي Merchant Center و"إعلانات Google".
	تعرَّف على كيفية إعداد قائمة منتجاتك باستخدام Content API.
	اطّلِع على الدليل إنشاء حملة Shopping باستخدام Google Ads API.

الاقتراحات وتغيير الحالة

	إذا لم تكن على دراية بوظائف الاقتراحات و سجلّ التغييرات ، جرِّبها في واجهة مستخدِم "إعلانات Google".
	توفّر Google Ads API خدمتَين تعكسان هذه الوظائف. تقترح واجهة برمجة التطبيقات RecommendationService اقتراحات تحسين مع تأثير مقدَّر، في حين تُستخدَم واجهة برمجة التطبيقات ChangeStatusService لعرض سجلّ التغييرات في حسابك، والذي يمكن استخدامه لأغراض متعددة، مثل مزامنة النسخة المحلية والتدقيق البسيط وغير ذلك.

RecommendationService

	اطّلِع على دليلنا حول كيفية استخدام RecommendationService لاسترداد اقتراحات Google وتطبيقها على حسابك لزيادة الأداء العام للإعلانات.
	يمكنك التعرّف على وظائف الاقتراحات من خلال تنفيذ نموذج الرمز البرمجي التالي: اقتراحات عيّنات -> الحصول على اقتراحات للإعلانات النصية.

ChangeStatusService

	اطّلِع على دليلنا حول كيفية استخدام ChangeStatusService لاسترداد سجلّ التغييرات من أجل تتبُّع التغييرات التي تطرأ على حسابك، مثل الحملات والإعلانات.
	يمكنك التعرّف على وظائف سجلّ التغييرات من خلال تنفيذ نموذج التعليمات البرمجية التالي: عيّنات ChangeStatus -> الحصول على تغييرات الحساب.

الاطّلاع على آخر الأخبار

يجب تعديل الرمز البرمجي باستمرار لتضمين التغييرات في Google Ads API.

تحديد الإصدار

	عند إيقاف إصدار رئيسي سابق نهائيًا، لن يعود متوافقًا ولن تُلبى طلبات بيانات واجهة برمجة التطبيقات التي يتم إجراؤها باستخدام إصدار سابق من واجهة برمجة التطبيقات. يُرجى الاطّلاع على آخر الأخبار المتعلّقة بواجهة برمجة التطبيقات باتّباع الخطوات التالية:
	عند إصدار واجهة برمجة تطبيقات جديدة، يمكنك الحصول على أحدث إصدار من مكتبة البرامج.
	أضِف إشارة مرجعية إلى أحدث ملاحظات الإصدار وراجِع التغيُّرات الرئيسية في كل إصدار.
	استبدِل طلبات البيانات إلى الإصدار السابق من مكتبة العميل بطلبات البيانات إلى الإصدار الجديد.
	يمكنك متابعة هذه المدوّنة للاشتراك في خلاصة RSS للحصول على مشاركات المدونة عبر البريد الإلكتروني، والاطّلاع على المنتدى للحصول على أحدث المعلومات المتعلّقة بخدمة Google Ads API.
	تأكَّد من أنّ عنوان البريد الإلكتروني المخصّص للتواصل بشأن واجهة برمجة التطبيقات والمسجَّل في مركز واجهة برمجة التطبيقات في حسابك الإداري الرئيسي محدَّث، لأنّنا سنتواصل معك من خلاله إذا رصدنا أي مشاكل فنية متعلّقة باستخدامك لواجهة برمجة التطبيقات.

منتجات Google ذات الصلة بالإعلانات

	Google Merchant Center	تساعدك خدمة Google Merchant Center في تحميل بيانات منتجاتك ومتجرك إلى Google وإتاحتها على إعلانات Shopping وخدمات Google الأخرى.
	الملف التجاري	يساعدك ملفك التجاري في الوصول إلى العملاء المحليين والتفاعل معهم على "بحث Google" و"خرائط Google".
	إحصاءات Google	توفّر "إحصاءات Google" تقارير تفصيلية عن كيفية استخدام المستخدِمين لموقعك الإلكتروني. ويمكنك استخدام "إحصاءات Google" للاطّلاع على الإجراءات التي يتخذها الأشخاص بعد النقر على إعلاناتك.
	إدارة العلامات من Google	أداة "إدارة العلامات من Google" هي نظام لإدارة العلامات (TMS) يتيح لك تعديل رموز التتبُّع ومقتطفات الرموز ذات الصلة، والتي تُعرف مجتمعةً باسم العلامات، على موقعك الإلكتروني أو تطبيقك المتوافق مع الأجهزة الجوّالة بسرعة.
	أدوات تحسين الأداء من Google	توفّر "أدوات تحسين الأداء من Google" أدوات اختبار أ/ب واختبار المواقع الإلكترونية والتخصيص للأنشطة التجارية الصغيرة للمساعدة في تقديم تجارب تفاعلية للعملاء.
	مركز البيانات من Google	يعمل "مركز البيانات" على تحويل بياناتك إلى لوحات بيانات وتقارير غنيّة بالمعلومات وسهلة القراءة والمشاركة وقابلة للتخصيص بالكامل.

الحصول على المساعدة

	أضِف إشارة مرجعية إلى أدلة Google Ads API. ويتم شرح معظم المفاهيم الأساسية بالتفصيل هناك.
	أضِف إشارة مرجعية إلى مرجع Google Ads API. ويتم شرح كل وظائف واجهة برمجة التطبيقات بالتفصيل هناك.
	أضِف إشارة مرجعية إلى صفحة دعم Google Ads API التي تشرح قنوات الدعم الرئيسية.
	يمكنك زيارة قناة YouTube الخاصة بمطوّري "إعلانات Google".
	تواصَل مع ممثّل نشاطك التجاري أو مدير الشركاء في Google لتحديد موعد اجتماع لمعالجة المشاكل الاستراتيجية الأكثر تعقيدًا المرتبطة بواجهة برمجة التطبيقات.