מעבר לגרסה חדשה

גרסאות חדשות של Campaign Manager 360 API מתפרסמות באופן קבוע. ככל שמתפרסמות גרסאות חדשות, הגרסאות הקודמות הופכות ללא תמיכה ובסופו של דבר הן מבוטלות. כשגרסה מסוימת תופסק, כל הבקשות לגרסה הזו יתחילו להחזיר שגיאות.

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

שלב 1: בודקים באיזו גרסה אתם משתמשים

אם אתם אחראים על אפליקציה שיש לכם חשד שהיא משתמשת בגרסה של Campaign Manager 360 API שהוצאה משימוש, תחילה עליכם לוודא באיזו גרסה ספציפית אתם משתמשים. ברוב המקרים, הגישה ל-API תתבצע דרך אחת מספריות הלקוח הספציפיות לשפה או דרך שילוב רשמי. בהמשך מפורטות הוראות לאיתור גרסת ה-API שבה נעשה שימוש בספריות הלקוח ובשילובים האלה:

העורך החדש של Apps Script

פרטי הגרסה של Apps Script מוצגים בתיבת הדו-שיח של השירותים המתקדמים:

1. בעורך של Apps Script, לוחצים על Add a service (הוספת שירות) .
2. מאתרים את Campaign Manager 360 API ברשימת השירותים הזמינים.
3. הערך שנבחר בתפריט הנפתח של הגרסה הוא גרסת ה-API של Campaign Manager 360 שבה נעשה שימוש כרגע.

העורך הקודם של Apps Script

פרטי הגרסה של Apps Script מוצגים בתיבת הדו-שיח של השירותים המתקדמים:

1. עוברים אל משאבים > שירותי Google מתקדמים בעורך של Apps Script.
2. מאתרים את Campaign Manager 360 API ברשימת השירותים הזמינים.
3. הערך שנבחר בתפריט הנפתח של הגרסה הוא גרסת ה-API של Campaign Manager 360 שבה נעשה שימוש כרגע.

C#‎

פרטי הגרסה של ספריית הלקוח של Google API ל-‎ .NET מוצגים במקומות הבאים:

1. נכלל בשם החבילה ב-NuGet ובמרחב השמות של השירות.

   Google.Apis.Dfareporting.v3_4

2. נחשף דרך מאפיין ציבורי של DfareportingService.

   Console.WriteLine(DfareportingService.Version);

Java

פרטי הגרסה של ספריית הלקוח של Google API ל-Java מוצגים במקומות הבאים:

1. מצוין ב-artifactId של Maven.

   <dependency>
     <groupId>com.google.apis</groupId>
     <artifactId>google-api-services-dfareporting</artifactId>
     <version>v3.4-rev1-1.21.0</version>
   </dependency>

2. כלול בשם הקובץ של ה-JAR.

   google-api-services-dfareporting-v3.4-rev1-1.21.0.jar

3. נחשף דרך מאפיין ציבורי של Dfareporting.

   System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);

PHP

פרטי הגרסה של ספריית הלקוח של Google API ל-PHP מוצגים באמצעות מאפיין ציבורי של Google_Service_Dfareporting:

$service = new Google_Service_Dfareporting($client)
print $service->version;

Python

ספריית הלקוח של Google API ל-Python (v1/v2) לא מחולקת לגרסאות. גרסת ה-API שבה רוצים להשתמש מצוינה כארגומנטים ל-discovery builder:

discovery.build('dfareporting', 'v3.4', http=http)

Ruby

ספריית הלקוח של Google API ל-Ruby בגרסאות 0.9 ואילך כוללת ניהול גרסאות. גרסת ה-API שבה רוצים להשתמש מצוינה כארגומנטים למבנה השירות:

service = Google::APIClient::Service.new("dfareporting", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)

בספריית הלקוח של Google API ל-Ruby בגרסאות 0.9 ואילך, הגרסה מוצגת במרחב השמות של השירות:

Google.Apis.DfareportingV3_4

חשוב לזכור את הגרסה שבה אתם משתמשים, כי תצטרכו את המידע הזה בהמשך.

שלב 2: בדיקת הסטטוס של הגרסה

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

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

אם אתם נמצאים באפשרות 2 או 3 שלמעלה, תצטרכו לעבור לגרסה חדשה יותר כדי למנוע שיבושים בשירות. מומלץ לעבור לגרסה האחרונה, שמופיעה בחלק העליון של טבלת לוח הזמנים להוצאה משימוש (לא כולל גרסאות בטא). כך תוכלו להאריך את משך הזמן בין השדרוגים.

שלב 3: שדרוג הגרסאות

אם החלטתם שצריך לבצע את ההעברה, השלב הבא הוא לעדכן את השילוב או לקבל גרסה מעודכנת של ספריית הלקוח המועדפת עליכם. חשוב לזכור: בחלק מספריות הלקוח יש רק build אחד שפועל עם כל גרסאות ה-API, אבל בספריות אחרות יש build נפרד לכל גרסה. ברשימה הבאה מפורט מידע כללי על השדרוג של השילובים וספריות הלקוח הנפוצים ביותר.

העורך החדש של Apps Script

Google Apps Script תומך בכל הגרסאות של Campaign Manager 360 API ומאפשר לכם לבחור את הגרסה שבה תרצו להשתמש בכל סקריפט בנפרד. כדי לשנות את הגרסה שבה נעשה שימוש בסקריפט מסוים:

1. בעורך של Apps Script, לוחצים על Add a service (הוספת שירות) .
2. מאתרים את Campaign Manager 360 API ברשימת השירותים הזמינים.
3. שינוי הגרסה של Campaign Manager 360 API שבשימוש באמצעות התפריט הנפתח של הגרסאות.
4. לוחצים על הוספה כדי לשמור את השינויים.

עורך קובצי הסקריפט הקודם של Apps Script

Google Apps Script תומך בכל הגרסאות של Campaign Manager 360 API ומאפשר לכם לבחור את הגרסה שבה תרצו להשתמש בכל סקריפט בנפרד. כדי לשנות את הגרסה שבה נעשה שימוש בסקריפט מסוים:

1. עוברים אל משאבים > שירותי Google מתקדמים בעורך של Apps Script.
2. מאתרים את Campaign Manager 360 API ברשימת השירותים הזמינים.
3. שינוי הגרסה של Campaign Manager 360 API שבשימוש באמצעות התפריט הנפתח של הגרסאות.
4. לוחצים על אישור כדי לשמור את השינויים.

C#‎

ספריית הלקוח של Google API ל-‎ .NET מספקת גרסאות build נפרדות לכל גרסה של Campaign Manager 360 API, שמופצות דרך Nuget.

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

Java

ספריית הלקוח של Google API ל-Java מספקת גרסאות build נפרדות לכל גרסה של Campaign Manager 360 API, שמופצות דרך Maven.

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

PHP

ספריית הלקוח של Google API ל-PHP מספקת גרסאות build נפרדות לכל גרסה של Campaign Manager 360 API, שמופצות דרך Packagist.

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

Python

כל גרסה של ספריית הלקוח של Google API ל-Python (v1/v2) תומכת בכל הגרסאות של Campaign Manager 360 API. פשוט מעדכנים את מחרוזת הגרסה שמועברת כארגומנטים ל-builder של מודעות Discovery:

discovery.build('dfareporting', 'v3.4', http=http)

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

Ruby

ספריית הלקוח של Google API ל-Ruby בגרסה 0.8 ואילך תומכת בכל הגרסאות של Campaign Manager 360 API. פשוט מעדכנים את מחרוזת הגרסה שמועברת כארגומנטים למבנה השירות:

service = Google::APIClient::Service.new("dfareporting", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)

בספריית הלקוח של Google API ל-Ruby בגרסה 0.9 ואילך יש גרסאות build נפרדות לכל גרסה של Campaign Manager 360 API, שמופצות דרך RubyGems. הוראות מפורטות להתקנה או אפשרויות הורדה חלופיות זמינות במסמכי התיעוד של ספריית הלקוח.

שלב 4: הבדלים בין גרסאות של כתובות

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

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

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

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

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

הישאר מעודכן

כפי שצוין קודם, אנחנו משחררים גרסאות חדשות של Campaign Manager 360 API ומסיימים את התמיכה בגרסאות קודמות באופן קבוע. עדכונים לגבי גרסאות חדשות, הוצאות משימוש והוצאות משימוש סופיות מתפרסמים בערוצים הבאים:

• בלוג למפתחים של Google Ads (הרשמה לקבלת התראות באימייל)
• פורום Campaign Manager 360 API

מומלץ להירשם לערוץ אחד או יותר מהערוצים האלה כדי להתעדכן בחדשות האחרונות בנושא ממשקי API.