الانتقال إلى المحتوى الرئيسي
GET
احصل على أداء Google Ads مباشرةً، بصف واحد لكل يوم، للحملات أو المجموعات الإعلانية أو الإعلانات التي أنشأتها عبر Ayrshare.
  • تُقرأ الأرقام من Google لحظة استدعائك، وليس من نسخة تُحدَّث كل ليلة.
  • جميع القيم النقدية بعملة حساب الإعلانات، وتُعاد في الحقل currency في كل صف.
  • يستبعد Google الأيام التي لا نشاط فيها، لذا قد يُعيد نطاق زمني صفوفًا أقل من عدد أيامه.
  • يعدّل Google تكلفة اليوم وإحالاته الناجحة لبضعة أيام بعد انتهائه، لذا قد تتغير الأيام الأخيرة بين قراءة وأخرى.
  • لحملة Performance Max، استخدم level=campaign مع معرّف الحملة. لا تحتوي حملة Performance Max على إعلانات خاصة بها، لذا لا يُعيد level=ad أي صفوف.

معاملات الترويسة

معاملات الاستعلام

string
مطلوب
ما يُبلغ عنه كل صف: campaign (قيمة campaignId من الإنشاء) أو adSet (قيمة adGroupId من الإنشاء) أو ad (قيمة adId من الإنشاء).
string
مطلوب
معرّفات الحملات أو المجموعات الإعلانية أو الإعلانات مفصولة بفواصل، بحد أقصى 50. يجب أن تكون جميعها في حساب إعلانات واحد.
string
معرّف عميل Google Ads المكوّن من 10 أرقام، مع الشرطات أو بدونها (123-456-7890).تقرأ تقارير الإعلانات والمجموعات الإعلانية حساب الإعلانات الذي تحدده هنا. وبدونه، يبحث تقرير الإعلانات في كل حسابات الإعلانات التي يصل إليها ربط Google Ads الخاص بك، بحد أقصى 25 حسابًا، ولا يعمل تقرير المجموعات الإعلانية إلا عندما يصل ربطك إلى حساب إعلانات واحد. حدّد الحساب عندما يصل ربطك إلى أكثر من 25 حساب إعلانات، أو إلى أكثر من حساب واحد في تقرير المجموعات الإعلانية. وإلا فسيُعيد الطلب code: 101.
string
المقاييس المطلوب إرجاعها مفصولة بفواصل. احذفه للحصول عليها جميعًا. راجع المقاييس.
string
افتراضي:"قبل 30 يومًا"
اليوم الأول، بصيغة YYYY-MM-DD. يحتفظ Google بالأرقام اليومية لمدة 37 شهرًا؛ ويُعيد startDate أقدم من ذلك code: 101.
string
افتراضي:"اليوم"
اليوم الأخير، بصيغة YYYY-MM-DD.

المقاييس

يظل actions وconversionValue بالقيمة 0 إلى أن يُعدّ تتبّع الإحالات الناجحة في حساب Google Ads الخاص بك. reach غير متاح، لأن Google لا يقدّم مدى وصول فريدًا لإعلانات البحث، وbreakdowns غير متاحة على Google. ويُعيد طلب أيٍّ منهما code: 101.

ترقيم الصفحات

تُعاد جميع الصفوف في استجابة واحدة، لذا تكون قيمة nextCursor دائمًا null.

الأخطاء