המדריך הזה מכיל דוגמאות לקריאה ישירה לנקודות הקצה ב-REST, ללא שימוש בספריית לקוח.
דרישות מוקדמות
אתם יכולים להעתיק ולהדביק בקלות את כל הדוגמאות הבאות למעטפת bash באמצעות הפקודה curl. צריך להיות לכם חשבון ניהול ב-Search Ads 360 שמכיל לפחות חשבון לקוח אחד.
משתני סביבה
מזינים למטה את פרטי הכניסה והמזהים של החשבון, ואז מעתיקים ומדביקים אותו בטרמינל כדי להגדיר את משתני הסביבה בדוגמאות הבאות.
API_VERSION="0"
OAUTH2_ACCESS_TOKEN="OAUTH_ACCESS_TOKEN"
MANAGER_CUSTOMER_ID="MANAGER_CUSTOMER_ID"
CUSTOMER_ID="CUSTOMER_ID"
מזהי אובייקטים אופציונליים נוספים
הדוגמאות הבאות רלוונטיות לקמפיינים קיימים. אם יש לכם מזהים של קמפיין קיים לשימוש בדוגמאות האלה, הזינו אותם בהמשך.
CAMPAIGN_ID=CAMPAIGN_ID
חיפוש בחלוקה לדפים
השיטה search
משתמשת בעימוד, עם פרמטר pageSize
שניתן להתאמה לצד query
.
cURL
#!/bin/bash # [START curl_command] curl -f --request POST "https://searchads360.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/searchAds360:search" \ --header "Content-Type: application/json" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data '{ "pageSize": 10, "query": " SELECT campaign.name, campaign_budget.amount_micros, campaign.status, campaign.advertising_channel_type, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros, campaign.bidding_strategy_type FROM campaign WHERE segments.date DURING LAST_7_DAYS AND campaign.status != 'REMOVED' " }' # [END curl_command]
שפת השאילתות ב-SA360
SELECT campaign.name, campaign_budget.amount_micros, campaign.status, campaign.advertising_channel_type, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros, campaign.bidding_strategy_type FROM campaign WHERE segments.date DURING LAST_7_DAYS AND campaign.status != 'REMOVED'
סטרימינג
השיטה searchStream
משדרת את כל התוצאות בתגובה אחת, ולכן השדה pageSize
לא נתמך.
cURL
#!/bin/bash # [START curl_command] curl -f --request POST "https://searchads360.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/searchAds360:searchStream" \ --header "Content-Type: application/json" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data '{ "query": " SELECT campaign.name, campaign_budget.amount_micros, campaign.status, campaign.advertising_channel_type, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros, campaign.bidding_strategy_type FROM campaign WHERE segments.date DURING LAST_7_DAYS AND campaign.status != 'REMOVED' " }' # [END curl_command]
שפת השאילתות ב-SA360
SELECT campaign.name, campaign_budget.amount_micros, campaign.status, campaign.advertising_channel_type, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros, campaign.bidding_strategy_type FROM campaign WHERE segments.date DURING LAST_7_DAYS AND campaign.status != 'REMOVED'