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

הערות מוצר

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

גרסה 2

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

2025-10-02

דוחות

נוסף המאפיין TRAFFIC_SOURCE, שמאפשר לפרק את המדדים לפי מקור תנועה (לדוגמה, Google,‏ Bing,‏ Facebook,‏ Other). מידע נוסף זמין במאמר פירוט מקורות התנועה.

2025-05-06

PolicyIssues

השדה policyTopics[].must_fix שהוצא משימוש (ראו את העדכון הקודם) תמיד יוגדר עכשיו לערך false.

2025-02-24

PolicyIssues

הוספנו שדה policyTopics[].type כדי לזהות אם נושא מדיניות מייצג בעיה שקשורה למדיניות, בעיה רגולטורית או העדפה של מפרסם. השדה הזה מחליף את השדה policyTopics[].must_fix, שמסומן עכשיו כשדה שהוצא משימוש.

2024-04-03

PolicyIssues

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

2023-06-19

תשלומים

הפונקציה payments.list מחזירה עכשיו פרטים על תשלומים לבעלי תוכן דיגיטלי במינוי Premium.

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 לפלטפורמות.
הוספנו את השדה 'פעיל' למשאב.

חשבונות

נוספה השיטה getAdBlockingRecoveryTag.

2022-08-25

דוחות

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

2022-05-03

AdClient

נוספה שיטת get.

דוחות

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

UrlChannels

נוספה שיטת get.

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

2021-06-30

אפשר לדווח עליו כאן

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

‫2021-04-19 (גרסה ראשונית)

כללי

כל השיטות שהוצאו משימוש בגרסה 1.4 הוסרו. כולל שיטות של משאבים שלא דרשו accountId. בגרסה 2, הערך של accountId מצוין בשדה parent.
בהתאם לתקנים של Google API, המשאבים מזוהים עכשיו באמצעות השדה name. לדוגמה, שם של AdClient ייראה כך: accounts/{accountId}/adclients/{adClientId}. בנוסף, בגרסה v1.4 המזהה של המשאב שימש כמאפיין בדוחות, אבל בגרסה v2 הערך הזה זמין עכשיו דרך השדה 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 כבר לא מציין אם הייתה פעילות ביחידת המודעות הזו ב-7 הימים האחרונים. בגרסה 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 הוא בוליאני שמייצג אם המודעות האוטומטיות הופעלו באתר מסוים.