שדרוג לגרסה העדכנית ביותר

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

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

ריכזנו כאן רשימת משימות שתעזור לכם להתחיל בתהליך השדרוג:

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

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

v15 עד v16

שינויים בשירותים וברכיבים שלהם
AccountLink הקישורים data_partner ו-google_ads ב-linked_account הוסרו. השתמשו ב-ProductLinkService וב-ProductLinkInvitationService במקום זאת.
CampaignLifecycleGoal כשמעדכנים קודם ערך CampaignLifecycleGoal קיים, צריך ליצור פעולה create עם דרישות ספציפיות. עכשיו אתם יכולים ליצור פעולה update כמו בסוגי משאבים אחרים במקום זאת.
דיווח על שגיאות בשני מקרים שבהם הוחזרה השגיאה ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT הגנרית, יתקבלו הודעות שגיאה ספציפיות יותר:
  • CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
  • CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
AudienceInsightsAttributeMetadata השדה score הוסר.
KeywordMatchTypeRecommendation אם סוג ההתאמה של מילת המפתח לא מוגדר, ה-API מחזיר עכשיו את הערך UNSPECIFIED במקום UNKNOWN בשדה recommended_match_type.

v14 עד v15

שינויים בשירותים וברכיבים שלהם
AssetGroupListingGroupFilter השם של השדה 'טיפוסים בני מנייה (enum)' vertical השתנה ל-feed_type.
MediaFileService השירות הוסר כי אין בו יותר צורך. אפשר לראות את השינוי במדד ImageAdInfo בהמשך.
ImageAdInfo השדה media_file הוחלף בשדה image_asset.
MerchantCenterLinkService השירות הוחלף ב- ProductLinkInvitationService וב- ProductLinkService.
Campaign.ShoppingSetting השדה sales_country הוסר. עכשיו המידע מוחזר בשדה feed_label.
ProductBiddingCategoryConstant הוחלף ב- ProductCategoryConstant. השמות של כמה שדות השתנו בהתאם. שלושת השינויים הבאים מופיעים בהמשך.
ListingDimensionInfo החלפנו את השדה product_bidding_category בערך product_category.
ListingGroupFilterDimension החלפנו את השדה product_bidding_category בערך product_category.
shopping_performance_view דוח שדות הפלחים הבאים:
  • product_bidding_category_level1
  • product_bidding_category_level2
  • product_bidding_category_level3
  • product_bidding_category_level4
  • product_bidding_category_level5
הוחלפו ב:
  • product_category_level1
  • product_category_level2
  • product_category_level3
  • product_category_level4
  • product_category_level5
Campaign.shopping_setting הוסרה התמיכה ביצירת קמפיינים לרשת החיפוש עם השדה הזה.
CampaignCriterion.listing_scope הוסרה התמיכה ביצירת קמפיינים לרשת החיפוש עם השדה הזה.
sk_ad_network_conversions דוח השדה metrics.sk_ad_network_conversions הוחלף ב-metrics.sk_ad_network_installs.
OfflineConversionClientSummary העברנו את השדה offline_conversion_client_summaries מ-Customer למשאב ברמה העליונה שאפשר להריץ עליו שאילתות בנפרד.

שינוי השאילתה מ:

SELECT customer.offline_conversion_client_summaries
FROM customer
אל: 
SELECT
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.total_event_count,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.last_upload_date_time,
  ...
FROM offline_conversion_upload_client_summary

משתמשים בכלי ליצירת שאילתות על מנת לבדוק את רשימת השדות הזמינים לבחירה ולסינון.
OfflineConversionUploadAlert שינינו את השם ל OfflineConversionAlert.
OfflineConversionUploadError שינינו את השם ל OfflineConversionError.
AdNetworkType הטיפוסים הטיפוסיים YOUTUBE_SEARCH ו- YOUTUBE_WATCH מוזגו ל-enum אחד: YOUTUBE.