مثال لحالة الاستخدام الشائعة

لنلقِ نظرة الآن على حالة استخدام شائعة: تلخيص أداء حساب خلال آخر 30 يومًا حسب الحملة، مقسّمة حسب الجهاز. في ما يلي طلب البحث عن هذا التقرير:

SELECT
  campaign.name,
  campaign.status,
  segments.device,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

لإصدار هذا الطلب، عليك تمرير بيان لغة طلبات البحث في "إعلانات Google" أعلاه إلى واجهة GoogleAdsService.SearchStream.

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

عنوان URL لطلب HTTP

يتألّف الطلب من طلب HTTP POST إلى خادم Google Ads API على عنوان URL التالي:

https://googleads.googleapis.com/v19/customers/{customer_id}/googleAds:searchStream

نموذج كامل لطلب HTTP

في ما يلي مثال كامل لتعريف التقرير أعلاه، مُدرَج في طلب HTTP POST.

POST /v19/customers/{customer_id}/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]
developer-token: [Enter developerToken here]

Parameters:
{
  "query" : "SELECT campaign.name, campaign.status, segments.device,
                    metrics.impressions, metrics.clicks, metrics.ctr,
                    metrics.average_cpc, metrics.cost_micros
            FROM campaign
            WHERE segments.date DURING LAST_30_DAYS"
}

عيّنات تعليمات برمجية

شاهِد فيديو يقدّم جولة تفصيلية حول نموذج رمز برمجي يبحث في الحملات باستخدام المقاييس خلال آخر 7 أيام. تم كتابة نموذج الرمز البرمجي في الفيديو بلغة Java، ولكن تتمثّل العملية نفسها في جميع اللغات.