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

تُلخّص حالة الاستخدام هذه أداء حساب على مدار آخر 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 Ads" هذا إلى الـ GoogleAdsService.SearchStream واجهة.

عنوان URL لطلب HTTP

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

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

استبدِل {customer_id} برقم تعريف حساب "إعلانات Google" الذي تريد الاستعلام عنه. لا تضمِّن الشرطات في رقم التعريف. إذا أردت استرداد بيانات حساب فرعي، عليك استخدام رقم تعريف هذا الحساب الفرعي. لا يؤدي الاستعلام باستخدام رقم تعريف حساب إداري إلا إلى عرض البيانات التي يملكها هذا الحساب الإداري مباشرةً، ولا يشمل بيانات حساباته الفرعية.

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

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

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