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

تلخّص حالة الاستخدام هذه أداء حساب على مدار آخر 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/v20/customers/{customer_id}/googleAds:searchStream

مثال على طلب HTTP كامل

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

POST /v20/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، ولكن العملية مماثلة لجميع اللغات.