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

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

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

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

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

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

v16 עד v17

שינויים בשירותים וברכיבים שלהם
GoogleAdsService Search ו-SearchStream בקשות	השגיאה שמופיעה בזמן ויסות נתונים (throttle) של הבקשה כי היא יקרה מדי תהיה QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION או QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION במקום QuotaError.RESOURCE_EXHAUSTED. בפוסט הזה בבלוג אפשר לקרוא פרטים נוספים.
GoogleAdsService בקשות Search.	העברת page_size ל-GoogleAdsService.Search תוביל לשגיאה RequestError.PAGE_SIZE_NOT_SUPPORTED.
הפקודה Campaign והפקודה Ad	במקום זאת, קמפיינים עם AdvertisingChannelType של DISCOVERY יקבלו עכשיו AdvertisingChannelType של DEMAND_GEN. בנוסף, מודעות מסוימות ישנו את שמות הסוג והשדות לצורך דיווח: DISCOVERY_MULTI_ASSET_ADD יהפוך ל-DEMAND_GEN_MULTI_ASSET_ADD ושדה הדיווח התואם ad_group_ad.ad.discovery_multi_asset_ad יהיה ad_group_ad.ad.demand_gen_multi_asset_ad DISCOVERY_CAROUSEL_AD יהפוך ל-DEMAND_GEN_CAROUSEL_AD ושדה הדיווח התואם ad_group_ad.ad.discovery_carousel_ad יהיה ad_group_ad.ad.demand_gen_carousel_ad DISCOVERY_VIDEO_RESPONSIVE_AD יהפוך ל-DEMAND_GEN_VIDEO_RESPONSIVE_AD ושדה הדיווח התואם ad_group_ad.ad.discovery_video_responsive_ad יהיה ad_group_ad.ad.demand_gen_video_responsive_ad
AdService	נקודת הקצה (endpoint) GetAd תוסר. באופן הזה, AdService יכול להתאים לשירותים אחרים ב-Google Ads API. מומלץ לעיין במדריך שלנו בנושא אחזור אובייקטים כדי ללמוד על הדרך המומלצת לאחזור מודעות וסוגי משאבים אחרים.
CustomerLifecycleGoal ו-CampaignLifecycleGoal	אופן הניהול של פלחים עבור יעדים של מחזורי חיים שונה. סקירה כללית מלאה זמינה בקטע פילוח הקהלים במאמרי העזרה בנושא מטרות עסקיות במחזור החיים.
ProductLink	כשמריצים בקשה מסוג GoogleAdsService לחיפוש או לזרם חיפוש, עבור product_link, עכשיו אפשר לבחור רק שדות שקשורים למוצר מקושר אחד. אם בוחרים כמה שדות ממוצרים מקושרים שונים, תופיע השגיאה QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE.
דיווח	שיניתם את השם של השדה metrics.sk_ad_network_conversion_value ל-metrics.sk_ad_network_fine_conversion_value.

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	השם של השדה vertical enum השתנה ל-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	הערכים של טיפוסים בני מנייה (enum) YOUTUBE_SEARCH ו- YOUTUBE_WATCH מוזגו ל-enum אחד: YOUTUBE.