בדף הזה מוצגות הערות לגבי המוצר AdSense Management API.
גרסה 2
בגרסה הזו בוצעו השינויים הבאים כדי להסיר פונקציונליות שהוצאה משימוש ולהתאים את AdSense Management API לסטנדרטים הנוכחיים של Google API. בהתאם לסכמת הגרסאות של Google API, עם הזמן נעדכן את הגרסה הזו כך שתכלול פונקציונליות נוספת (התאמה לאחור), במקום פונקציונליות חדשה שתפורסם בגרסאות משניות נפרדות.
2023-06-19
תשלומים
- payments.list מחזיר עכשיו פרטים לגבי תשלומים עבור בעלי אתרים נבחרים.
2023-06-13
דוחות
- נוספו המדדים
FUNNEL_REQUESTS
,FUNNEL_IMPRESSIONS
,FUNNEL_CLICKS
ו-FUNNEL_RPM
שמספקים מידע על הביצועים של יחידות שאינן מודעות (למשל יחידות של חיפוש קשור).
2023-03-30
דוחות
- נוסף המאפיין
PAGE_URL
, שמאפשר פירוט של המדדים לפי כתובת URL של דף (עם כמה נקודות שחשוב לשים אליהן לב, אפשר לעיין בפירוט של כתובת ה-URL של הדף).
2022-09-21
AdUnits
- נוספו שיטות ליצירה ולתיקון. לתשומת ליבך, רק פרויקטים שהופעלו במוצר AdSense לפלטפורמות יכולים להשתמש בשיטות האלה.
CustomChannels
- נוספו שיטות ליצירה, תיקון ועדכון. לתשומת ליבך, רק פרויקטים שהופעלו במוצר AdSense לפלטפורמות יכולים להשתמש בשיטות האלה.
- השדה הפעיל נוסף למשאב.
חשבונות
- השיטה getAdblockRecoveryTag נוספה.
2022-08-25
דוחות
- נוסף המאפיין
HOSTED_AD_CLIENT_ID
, שמאפשר לבעלי תוכן דיגיטלי שמתארחים בפלטפורמה ובמארחים להציג פירוט של המדדים לפי החשבונות של בעל התוכן הדיגיטלי (בעלי תוכן דיגיטלי מארח) ולפי חשבונות משנה (בעלי תוכן דיגיטלי בפלטפורמה).
2022-05-03
AdClient
- נוספה שיטת אחזור.
דוחות
- נוספה שיטת getSaved.
UrlChannels
- נוספה שיטת אחזור.
2022-03-31
חשבון
- חשבונות לא פעילים מוחזרים עכשיו על ידי ה-API, עם השדה
state
שמציין את מצב החשבון.
AdClient
- בדומה לשינויים בחשבון שמפורטים למעלה, לקוחות מודעות לא פעילים מוחזרים עכשיו על ידי ה-API, עם
השדה
state
שמציין את המצב של לקוח המודעה.
2022-02-24
תשלום
-
פורמט שם המשאב הורחב כדי לתמוך במשאבים נפרדים
לרווחים מ-YouTube. השינוי הזה בוצע לפני ההשקה ההדרגתית של
חוויית המשתמש המשופרת ב-AdSense ליוצרים ב-YouTube. במסגרת התוכנית, הרווחים מ-YouTube יופרדו לחשבון תשלומים נפרד. פרטי התשלום מ-YouTube יוחזרו גם
מאמצעי התשלום ברשימת התשלומים, אחרי שיהיה לך
חשבון תשלומים ייעודי לרווחים מ-YouTube.
הרווחים מ-YouTube יופיעו בפורמט הבא של שם המשאב:
- accounts/{account}/payments/youtube-unpaid עבור רווחים (נוכחיים) מ-YouTube שלא שולמו.
- accounts/{account}/payments/youtube-yyyy-MM-dd לרווחים בתשלום מ-YouTube.
הערה: שמות המשאבים לגבי רווחים של AdSense לא משתנים:- accounts/{account}/payments/שטרם שולמו עבור רווחים (נוכחיים) מ-AdSense.
- accounts/{account}/payments/yyyy-MM-dd על רווחים מ-AdSense ששולמו.
2021-06-30
דיווח
- נוספו את המאפיינים
AD_FORMAT_NAME
ו-AD_FORMAT_CODE
, המציינים את האופן שבו מודעה מוצגת למשתמשים באתר שלך (בתוך הדף, מודעות ביניים וכו'). חשוב לשים לב שבגרסה 1.4 היו מאפיינים (הוצאו משימוש) עם אותם שמות אבל חברים שונים. שני המאפיינים שנוספו בגרסה 2 שונים מאלה שהיו בגרסה 1.4.
19.04.2021 (גרסה ראשונית)
כללי
- כל השיטות שהוצאו משימוש בגרסה 1.4 הוסרו. כולל שיטות של משאבים שלא דרשו
accountId
. בגרסה 2, הערךaccountId
מצוין בשדהparent
. - לפי הסטנדרטים של Google API, המשאבים מזוהים עכשיו באמצעות השדה
name
. לדוגמה, שם של לקוח AdClient ייראה כך:accounts/{accountId}/adclients/{adClientId}
. בנוסף, בגרסה 1.4 מזהה המשאב שימש כמאפיין דיווח, אבל בגרסה 2 הערך הזה זמין עכשיו דרך השדהreporting_dimension_id
במספר משאבים. - השדה
kind
הוסר מכל המשאבים.
חשבון
- השדה
name
השתנה ועכשיו הואdisplay_name
. - השדה
timezone
השתנה ממחרוזת ל-google.type.TimeZone
. - השדה
creation_time
(סוג int64) השתנה ל-create_time
(סוגgoogle.protobuf.Timestamp
). - נוסף שדה
pending_tasks
שכולל רשימה של משימות שעדיין לא בוצעו במסגרת תהליך ההרשמה לחשבון חדש. לדוגמה, משימות יכולות להיות קשורות לפרופיל החיוב או לאימות מספר הטלפון. - השדה
sub_accounts
הוסר. אפשר להשיג פונקציונליות דומה בגרסה 2 באמצעות השיטה המותאמת אישיתlistChildAccounts
. ניתן ליצור את עץ חשבונות הצאצא המלא בגרסה 2 על ידי קריאה חוזרת ל-listChildAccounts
.
AdClient
- השדה
arc_opt_in
הוסר כי הוא כבר הוסר מממשק המשתמש של AdSense. - השדה
supports_reporting
מוחלף בשדהreporting_dimension_id
, שמייצג את המזהה הייחודי של לקוח המודעה כפי שנעשה בו שימוש במאפיין הדיווחAD_CLIENT_ID
. אם השדהreporting_dimension_id
ריק, AdClient לא תומך בדיווח.
AdUnit
- השם של השדה
status
השתנה ל-state
. כמו כן, המצבACTIVE
לא מציין עוד אם הייתה פעילות ביחידת המודעות הזו בשבעת הימים האחרונים. בגרסה 2, המשמעות היא שיחידת המודעות הופעלה על ידי המשתמש ויכולה להציג מודעות. - השדה
code
הוסר. הערך עדיין יופיע בסוף השדהname
(אחרי הקו הנטוי הקדמי האחרון). - השדה
contentAdsSettings.backupOption
הוסר. - השדה
type
הוגבל לערכיםTYPE_UNSPECIFIED
,DISPLAY
,FEED
,ARTICLE
,MATCHED_CONTENT
ו-LINK
. - גם שדות אחרים שכבר הוסרו בממשק המשתמש של AdSense יוסרו:
custom_style
,saved_style_id
,mobile_content_ads_settings
,feed_ads_settings
.
התראה
- השיטה
delete
הוסרה. - השדה
is_dismissible
הוסר. - השם של השדה
locale
השתנה ועכשיו הואlanguage_code
.
CustomChannel
- השדה
code
הוסר. הערך עדיין יופיע בסוף השדהname
(אחרי הקו הנטוי הקדמי האחרון). - השדה
targeting_info
הוסר כי הוא כבר הוסר מממשק המשתמש של AdSense.
תשלום
- השם של השדה
payment_date
השתנה ל-date
והשם שלו השתנה ממחרוזת סוג לסוגgoogle.type.Date
. - השדה
payment_amount
והשדהpayment_amount_currency_code
שולבו לשדהpayment
אחד (למשל, " ¥1,235 JPY", "1,234.57$" , "87.65£").
דיווח
- בגרסה 2, נתוני הדיווח ב-AdSense Management API תואמים עכשיו לממשק המשתמש של AdSense. המשמעות היא שאין יותר תמיכה בנכסים של AdMob ו-YouTube. בנוסף, ה-API יתמוך רק בנתוני דוחות מ-3 שנים אחורה.
- המשאב
Metadata.dimensions
והמשאבMetadata.metrics
הוסרו. - נוספו שיטות חדשות ליצירת גרסת CSV של הדוח, שמחליפים את הפרמטרים של השאילתה בגרסה 1.4. הערה: כדי לבצע דחיסה, עדיין אפשר להשתמש בכותרת ה-HTTP "Accept-Encoding: gzip".
-
חלק מהשדות השתנו ביצירת דוח אד-הוק.
- השם של השדה
account_id
השתנה ועכשיו הואaccount
. - השם של השדה
dimension
השתנה ועכשיו הואdimensions
. - השם של השדה
metric
השתנה ועכשיו הואmetrics
. - השם של השדה
filter
השתנה ועכשיו הואfilters
. - השם של השדה
sort
השתנה ועכשיו הואorder_by
. - השם של השדה
locale
השתנה ועכשיו הואlanguage_code
. - השם של השדה
currency
השתנה ועכשיו הואcurrency_code
. - עכשיו אפשר לציין כמה טווחים נפוצים עם
date_range
(למשל,TODAY
,YESTERDAY
,MONTH_TO_DATE
,YEAR_TO_DATE
,LAST_7_DAYS
ו-LAST_30_DAYS
), ואפשר גם לצייןstart_date
ו-end_date
על ידי הגדרתdate_range
לערךCUSTOM
. - השדות
start_date
ו-end_date
השתנו ממחרוזת סוג לסוגgoogle.type.Date
. הערה: כתוצאה מכך, מילות מפתח שקשורות לתאריך היחסי (למשל, "today-6d") כבר לא נתמכים. - השדה הבוליאני
use_timezone_reporting
הוחלף ב-reporting_time_zone
, שיכול לקבל אחד משני ערכים:ACCOUNT_TIME_ZONE
אוGOOGLE_TIME_ZONE
(שפירושו PST/PDT). ברירת המחדל בגרסה 2 היאACCOUNT_TIME_ZONE
, שהיא שונה מברירת המחדל בגרסה 1.4. - השדה
start_index
הוסר. - השם של השדה
max_results
השתנה ועכשיו הואlimit
.
- השם של השדה
-
חלק מהשדות השתנו ביצירת דוח שמור.
- נוספו שדות תאריכים (
date_range
,start_date
,end_date
,reporting_time_zone
). - נוסף השדה
currency_code
. - השם של השדה
locale
השתנה ועכשיו הואlanguage_code
. - השדה
start_index
הוסר. - השדה
max_results
הוסר.
- נוספו שדות תאריכים (
SavedAdStyle
SavedAdStyle
הוסר כי הוא כבר הוסר מממשק המשתמש של AdSense.
אתר
-
Sites
נוספו כדי לאחזר נתונים לגבי אתרים שהוספת לחשבון AdSense שלך. - השדה
state
מייצג אם האתר נמצא באחד מהמצבים הבאים:REQUIRES_REVIEW
,GETTING_READY
,READY
,NEEDS_ATTENTION
. - השדה
auto_ads_enabled
הוא בוליאני שמציין אם מודעות אוטומטיות הופעלו באתר מסוים.
גרסה 1.4
הגרסה הזו כוללת את הפונקציונליות הבאה:
- עכשיו אפשר לרשום את התשלומים בחשבון AdSense במטבע המתאים.
- עכשיו אפשר לסגור התראה באמצעות קריאה ל-method
delete
, שתסתיר את ההתראה בממשק ה-API ובממשק האינטרנט של AdSense. - התשובה לדוח כוללת עכשיו את תאריכי ההתחלה והסיום. חשוב לעשות זאת
אם משתמשים בתאריכים יחסיים בזמן הפקת דוחות (למשל
today
,yesterday
,firstDayOfMonth-1m
), התגובה כוללת עכשיו את טווח התאריכים שביקשת.
בעיות מוכרות
השדה currency
בדוחות לא נתמך בגרסה הזו.
גרסה 1.3
הגרסה הזו כוללת את הפונקציונליות הבאה:
- היכולת לאחזר התראות.
- היכולת לאחזר מטא-נתונים של מדדים ומאפיינים.
- יכולת להפיק דוחות באזור הזמן המקומי של החשבון.
בעיות מוכרות
השדה currency
בדוחות לא נתמך בגרסה הזו.
גרסה 1.2
הגרסה הזו כוללת את הפונקציונליות הבאה:
- היכולת לאחזר סגנונות של מודעות.
- היכולת לאחזר ולהפעיל את הדוחות השמורים שהוגדרו בממשק הקצה.
בעיות מוכרות
השדה currency
בדוחות לא נתמך בגרסה הזו.
גרסה 1.1
הגרסה הזו כוללת את הפונקציונליות הבאה:
- היכולת לציין חשבונות שאליהם יש למשתמש גישה
- היכולת לבצע קריאת GET בחשבון ספציפי
- האפשרות לבצע שיחות GET ביחידות של מודעות ובערוצים מותאמים אישית.
- היכולת לזהות את החיבורים בין יחידות של מודעות לבין ערוצים מותאמים אישית
- ערוצים מותאמים אישית מכילים נתונים נוספים על פרטי מיקוד
בנוסף, עכשיו יש לך אפשרות לגשת לנתונים מתוך חשבון ברירת המחדל שלך או דרך חשבון ספציפי.
בעיות מוכרות
השדה currency
בדוחות לא נתמך בגרסה הזו.
גרסה 1
זאת הגרסה הראשונה של ה-API. השירות כולל תמיכה באחזור לקוחות מודעות, יחידות של מודעות, ערוצים מותאמים אישית וערוצים של כתובות אתרים, ובהפקת דוחות.
בעיות מוכרות
השדה currency
בדוחות לא נתמך בגרסה הזו.