อัปเกรดเป็นเวอร์ชันล่าสุด

คุณอาจต้องการอัปเกรดจาก Google Ads API เวอร์ชันหลักเก่าเป็นเวอร์ชันหลักที่ใหม่กว่าเป็นระยะๆ อาจเป็นเพราะเวอร์ชันที่กำลังหยุดให้บริการ หรืออาจเป็นเพราะคุณต้องการใช้ฟีเจอร์ใหม่ เราขอแนะนำให้อัปเกรดเป็นเวอร์ชันใหม่ล่าสุดเสมอ

โปรดดูกำหนดการเลิกใช้งานเพื่อวางแผนการอัปเกรด ดูคำแนะนำการกำหนดเวอร์ชันเพื่อเรียนรู้วิธีการทำงานของการกำหนดเวอร์ชัน

รายการตรวจสอบที่จะช่วยคุณเริ่มต้นกระบวนการอัปเกรดมีดังนี้

  1. ปลายทางจะเปลี่ยนแปลงเมื่อเปลี่ยนเวอร์ชันหลัก อัปเดตไลบรารีของไคลเอ็นต์เพื่อใช้ปลายทางใหม่ล่าสุด
  2. อ่านบันทึกประจำรุ่นเพื่อดูการเปลี่ยนแปลงที่เริ่มใช้ในแต่ละรุ่น
  3. โปรดดูตารางด้านล่างซึ่งมีสิ่งที่ควรมุ่งเน้นสำหรับเวอร์ชันที่คุณกำลังอัปเกรด

หากต้องการดูภาพรวมที่ครอบคลุมของการเปลี่ยนแปลงที่อิงตามความแตกต่างระหว่างโปรโตจากทั้ง 2 เวอร์ชัน โปรดดูตารางความแตกต่าง

v16 ถึง v17

การเปลี่ยนแปลงบริการและองค์ประกอบ
GoogleAdsService คำขอ Search และ SearchStream

ข้อผิดพลาดเมื่อมีการควบคุมคำขอเนื่องจากมีราคาแพงเกินไปจะเป็น 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 ระบบจะนำปลายทาง 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 เช่นเดียวกับทรัพยากรประเภทอื่นๆ ได้แล้ว
Error Reporting 2 กรณีที่การแสดงข้อผิดพลาด 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 ยกเลิกการสนับสนุนการสร้างแคมเปญ Search โดยใช้ช่องนี้
CampaignCriterion.listing_scope ยกเลิกการสนับสนุนการสร้างแคมเปญ Search โดยใช้ช่องนี้
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