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

نلقي نظرة الآن على حالة استخدام شائعة: تلخص أداء الحساب على مدار آخر 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/v17/customers/{customer_id}/googleAds:searchStream

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

في ما يلي مثال كامل لتعريف التقرير أعلاه، وهو مضمن في طلب HTTP POST.

POST /v17/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، ولكن هذه العملية متشابهة لجميع اللغات.