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

הערות מוצר

בדף הזה מוצגות הערות לגבי המוצר 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 הוא בוליאני שמציין אם מודעות אוטומטיות הופעלו באתר מסוים.