คุณอาจต้องการอัปเกรดจาก Google Ads API เวอร์ชันหลักเก่าเป็นเวอร์ชันหลักที่ใหม่กว่าเป็นระยะๆ อาจเป็นเพราะเวอร์ชันที่กำลังหยุดให้บริการ หรืออาจเป็นเพราะคุณต้องการใช้ฟีเจอร์ใหม่ เราขอแนะนำให้อัปเกรดเป็นเวอร์ชันใหม่ล่าสุดเสมอ
โปรดดูกำหนดการเลิกใช้งานเพื่อวางแผนการอัปเกรด ดูคำแนะนำการกำหนดเวอร์ชันเพื่อเรียนรู้วิธีการทำงานของการกำหนดเวอร์ชัน
รายการตรวจสอบที่จะช่วยคุณเริ่มต้นกระบวนการอัปเกรดมีดังนี้
- ปลายทางจะเปลี่ยนแปลงเมื่อเปลี่ยนเวอร์ชันหลัก อัปเดตไลบรารีของไคลเอ็นต์เพื่อใช้ปลายทางใหม่ล่าสุด
- อ่านบันทึกประจำรุ่นเพื่อดูการเปลี่ยนแปลงที่เริ่มใช้ในแต่ละรุ่น
- โปรดดูตารางด้านล่างซึ่งมีสิ่งที่ควรมุ่งเน้นสำหรับเวอร์ชันที่คุณกำลังอัปเกรด
หากต้องการดูภาพรวมที่ครอบคลุมของการเปลี่ยนแปลงที่อิงตามความแตกต่างระหว่างโปรโตจากทั้ง 2 เวอร์ชัน โปรดดูตารางความแตกต่าง
v16 ถึง v17
การเปลี่ยนแปลงบริการและองค์ประกอบ | |
---|---|
GoogleAdsService
คำขอ Search และ SearchStream |
ข้อผิดพลาดเมื่อมีการควบคุมคำขอเนื่องจากมีราคาแพงเกินไปจะเป็น |
GoogleAdsService
Search คำขอ |
การส่ง |
Campaign และ 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 ทั่วไปทำให้เกิดข้อความแสดงข้อผิดพลาดที่เฉพาะเจาะจงมากขึ้นดังนี้
|
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
รายงาน |
ฟิลด์กลุ่มต่อไปนี้
|
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
|