הערות מוצר

בדף זה מוצגות הערות המוצר של AdSense Management API.

גרסה 2

הגרסה הזו כוללת את השינויים הבאים במטרה להסיר פונקציונליות שהוצאה משימוש ולהתאים את AdSense Management API לסטנדרטים הנוכחיים של Google API. בהתאם לסכמת הגרסאות של Google API, הגרסה הזו תעודכן עם הזמן ותכלול פונקציונליות נוספת (תאימות לאחור), במקום פונקציונליות חדשה שתפורסם בגרסאות משניות נפרדות.

2024-04-03

PolicyIssues

  • נוסף אוסף חדש לדיווח על הפרות מדיניות ואזהרות קיימות בחשבון.

2023-06-19

תשלומים

  • payments.list מחזיר עכשיו פרטים על תשלומים עבור בעלי אתרים נבחרים.

2023-06-13

דוחות

  • נוספו המדדים FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS ו-FUNNEL_RPM שמספקים מידע על הביצועים של יחידות שהן לא יחידות של מודעות (לדוגמה, יחידות של חיפוש קשור).

2023-03-30

דוחות

2022-09-21

AdUnits

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

CustomChannels

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

חשבונות

  • השיטה getAdBlockRecoveryTag נוספה.

2022-08-25

דוחות

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

2022-05-03

AdClient

  • נוספה שיטת get.

דוחות

  • נוספה שיטת getSaved.

UrlChannels

  • נוספה שיטת get.

2022-03-31

חשבון

AdClient

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 היו מאפיינים (הוצאו משימוש) עם אותם שמות אבל חברים שונים; שני המאפיינים שנוספו ב-v2 שונים מאלה שהיו בגרסה 1.4.

2021.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. ניתן ליצור את עץ חשבונות הצאצא המלא ב-v2 על ידי קריאה רק ל-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. הערה: כתוצאה מכך, מילות מפתח עם תאריך יחסי (למשל, "היום-6 ימים") כבר לא נתמכות.
    • השדה הבוליאני 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 במטבע המתאים.
  • עכשיו אפשר לסגור התראה על ידי קריאה לשיטה delete שתסתיר את ההתראה בממשק ה-API ובממשק האינטרנט של AdSense.
  • התשובה לדוח כוללת עכשיו את תאריכי ההתחלה והסיום. זה חשוב אם משתמשים בתאריכים יחסיים כשיוצרים דוחות (כמו today, yesterday, firstDayOfMonth-1m), התגובה כוללת עכשיו את טווח התאריכים שביקשת.

בעיות מוכרות

השדה currency בדוחות לא נתמך בגרסה הזו.

גרסה 1.3

הגרסה הזו כוללת את הפונקציונליות הבאה:

  • היכולת לאחזר התראות.
  • היכולת לאחזר מטא-נתונים של מדדים ומאפיינים.
  • היכולת להפיק דוחות באזור הזמן המקומי של החשבון.

בעיות מוכרות

השדה currency בדוחות לא נתמך בגרסה הזו.

גרסה 1.2

הגרסה הזו כוללת את הפונקציונליות הבאה:

  • היכולת לאחזר סגנונות של מודעות.
  • היכולת לאחזר ולהפעיל את הדוחות השמורים שהוגדרו בממשק הקצה.

בעיות מוכרות

השדה currency בדוחות לא נתמך בגרסה הזו.

גרסה 1.1

הגרסה הזו כוללת את הפונקציונליות הבאה:

בנוסף, עכשיו יש לך גישה לנתונים דרך חשבון ברירת המחדל או דרך חשבון ספציפי.

בעיות מוכרות

השדה currency בדוחות לא נתמך בגרסה הזו.

גרסה 1

זאת הגרסה הראשונה של ממשק ה-API. השירות כולל תמיכה באחזור לקוחות של מודעות, יחידות של מודעות, ערוצים מותאמים אישית וערוצים של כתובות URL, והרצת דוחות.

בעיות מוכרות

השדה currency בדוחות לא נתמך בגרסה הזו.