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

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

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

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

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

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

v17 ถึง v18

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

ข้อผิดพลาดเมื่อคำขอถูกจำกัดเนื่องจากมีค่าใช้จ่ายสูงเกินไปจะแสดงเป็น QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION หรือ QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION แทน QuotaError.RESOURCE_EXHAUSTED ดูบล็อก post เพื่อดูรายละเอียดเพิ่มเติม
GoogleAdsService ตอนนี้ช่อง summary_row_setting และ return_total_results_count ใน SearchGoogleAdsRequest เป็นส่วนหนึ่งของออบเจ็กต์ SearchSettings ใหม่แล้ว
AssetType เปลี่ยนชื่อค่า enum DISCOVERY_CAROUSEL_CARD เป็น DEMAND_GEN_CAROUSEL_CARD แล้ว การดำเนินการนี้สอดคล้องกับการเปลี่ยนแปลงก่อนหน้านี้ เพื่อเปลี่ยนชื่อแคมเปญ Discovery เป็นแคมเปญ Demand Gen
AudienceInsightsService.GenerateSuggestedTargetingInsights ย้ายช่อง audience, baseline_audience และ data_month ไปไว้ในช่อง audience_definition แล้ว
DemandGenCampaignSettings ค่าเริ่มต้นของช่อง upgraded_targeting ในขณะนี้คือ true จากเดิม false
LocalServicesLeadConversation ฟิลด์ phone_call_details.call_recording_url จะไม่สามารถใช้งานได้อีกต่อไป สำหรับการเรียกแบบคงที่

v16 ถึง v17

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

ระบบอาจควบคุมคําขอของคุณหากคําค้นหาแพงเกินไป หากใช่ คุณจะได้รับข้อผิดพลาด QuotaError.RESOURCE_EXHAUSTED ดูบล็อก post เพื่อดูรายละเอียดเพิ่มเติม
GoogleAdsService คำขอ Search รายการ

การส่ง page_size ไปยัง GoogleAdsService.Search จะทำให้เกิดข้อผิดพลาด RequestError.PAGE_SIZE_NOT_SUPPORTED
Campaign และ Ad

แคมเปญที่มี AdvertisingChannelType of DISCOVERY จะเป็น AdvertisingChannelType of 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