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

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

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

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

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

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

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 เราได้เปลี่ยนชื่อช่องหลายช่องแล้ว โปรดดูการเปลี่ยนแปลง 3 แบบถัดไปด้านล่าง
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