דף זה תורגם על ידי Cloud Translation API.

הערות מוצר

בדף הזה תמצאו נתוני גרסה של AdSense Management API.

גרסה 2

בגרסה הזו בוצעו השינויים הבאים, כדי להסיר פונקציונליות שהוצאה משימוש ולהתאים את ממשק ה-API לניהול AdSense לסטנדרטים הנוכחיים של 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

יחידות מודעות

נוספו שיטות יצירה ותיקון. לידיעתכם, אפשר להשתמש בשיטות האלה רק בפרויקטים שמופעל בהם המוצר AdSense לפלטפורמות.

ערוצים מותאמים אישית

נוספו שיטות יצירה, תיקון ועדכון. לידיעתכם, אפשר להשתמש בשיטות האלה רק בפרויקטים שמופעל בהם המוצר AdSense לפלטפורמות.
השדה הפעיל נוסף למשאב.

חשבונות

הוספת שיטת getAdBlockrecoveryTag.

2022-08-25

דוחות

הוספנו את המאפיין HOSTED_AD_CLIENT_ID, שמאפשר לבעלי אתרים מארחים ולפלטפורמות להציג פירוט של מדדים לפי החשבונות של בעלי התוכן הדיגיטלי (בעלי תוכן דיגיטלי שמתארחים במארחים) ולפי חשבונות משנה (בעלי תוכן דיגיטלי שמשתמשים בפלטפורמות).

2022-05-03

לקוח פרסום

נוספה שיטת אחזור.

דוחות

נוספה שיטת getSaved.

UrlChannels

נוספה שיטת אחזור.

2022-03-31

חשבון

חשבונות לא פעילים מוחזרים עכשיו על ידי ה-API, עם השדה state שמציין את מצב החשבון.

לקוח פרסום

בדומה לשינויים שצוינו למעלה, לקוחות לא פעילים של מודעות מוחזרים עכשיו על ידי ה-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/unpaid על רווחים מ-AdSense שטרם שולמו (הנוכחיים).
- accounts/{account}/payments/yyyy-MM-dd על רווחים מ-AdSense ששולמו.

2021-06-30

דיווח

המאפיינים AD_FORMAT_NAME ו-AD_FORMAT_CODE נוספו, שמציינים את האופן שבו מודעה מסוימת מוצגת למשתמשים באתר שלך (מודעות להצגה בדף, מודעות ביניים וכו'). חשוב לציין שלגרסה 1.4 יש מאפיינים (שהוצאו משימוש) עם שמות זהים אבל חברים שונים. שני המאפיינים שנוספו בגרסה 2 שונים מהמאפיינים שמופיעים בגרסה 1.4.

19 באפריל 2021

כללי

כל השיטות שהוצאו משימוש בגרסה 1.4 הוסרו. כולל שיטות למשאבים שלא דרשו accountId. בגרסה 2, השדה accountId מצוין בשדה parent.
לפי הסטנדרטים של Google API, המשאבים מזוהים עכשיו לפי השדה name. לדוגמה, השם של לקוח AdWords ייראה כך: 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.

לקוח פרסום

השדה arc_opt_in הוסר מפני שהוא כבר הוסר מממשק המשתמש של AdSense.
השדה supports_reporting מוחלף בשדה reporting_dimension_id, שמייצג את המזהה הייחודי של לקוח המודעות, כפי שנעשה בו שימוש במאפיין הדיווח AD_CLIENT_ID. אם השדה reporting_dimension_id ריק, המשמעות היא ש-AdClient לא תומך בדיווח.

יחידת מודעות

השם של השדה 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.

ערוץ מותאם אישית

השדה 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-Enencoded: 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 הוסר מפני שהוא כבר הוסר מממשק המשתמש של AdSense.

אתר

Sites נוספו לאחזור נתונים לגבי אתרים שהוספת לחשבון AdSense שלך.
השדה state מציין אם האתר הוא אחד מהמצבים הבאים: REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION.
השדה auto_ads_enabled הוא ערך בוליאני שמייצג אם מודעות אוטומטיות הופעלו באתר מסוים.