ย้ายข้อมูลไปยังเวอร์ชันใหม่

เราจะเผยแพร่ API ของ Campaign Manager 360 เวอร์ชันใหม่เป็นประจำ เมื่อมีการเปิดตัวเวอร์ชันใหม่ ระบบจะเลิกใช้งานเวอร์ชันก่อนหน้าและปิดตัวในที่สุด เมื่อหยุดให้บริการเวอร์ชันหนึ่งแล้ว คำขอทั้งหมดที่ส่งไปยังเวอร์ชันนั้นจะเริ่มแสดงข้อผิดพลาด

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

ขั้นตอนที่ 1: ระบุเวอร์ชันที่คุณใช้อยู่

คุณสามารถตรวจสอบเวอร์ชัน API ที่ใช้อยู่ได้โดยทำตาม วิธีการต่อไปนี้ ในกรณีส่วนใหญ่ คุณจะเข้าถึง API โดยใช้ไลบรารีของไคลเอ็นต์เฉพาะภาษาหรือการผสานรวมอย่างเป็นทางการ

เครื่องมือแก้ไข Apps Script แบบใหม่

ข้อมูลเวอร์ชันของ Apps Script จะแสดงในกล่องโต้ตอบบริการขั้นสูง ดังนี้

1. จากเครื่องมือแก้ไขสคริปต์ของ Apps Script ให้คลิกเพิ่มบริการ
2. ค้นหา Campaign Manager 360 API ในรายการบริการที่พร้อมใช้งาน
3. ค่าที่เลือกในเมนูแบบเลื่อนลงของเวอร์ชันคือเวอร์ชัน API ของ Campaign Manager 360 ที่ใช้งานอยู่

เครื่องมือแก้ไข Apps Script เวอร์ชันเดิม

ข้อมูลเวอร์ชันของ Apps Script จะแสดงในกล่องโต้ตอบบริการขั้นสูง ดังนี้

1. จากโปรแกรมแก้ไข Apps Script ให้ไปที่ทรัพยากร > บริการขั้นสูงของ Google
2. ค้นหา Campaign Manager 360 API ในรายการบริการที่พร้อมใช้งาน
3. ค่าที่เลือกในเมนูแบบเลื่อนลงของเวอร์ชันคือเวอร์ชัน API ของ Campaign Manager 360 ที่ใช้งานอยู่

C#

ข้อมูลเวอร์ชันของไลบรารีของไคลเอ็นต์ Google API สำหรับ .NET จะแสดงในตำแหน่งต่อไปนี้

1. รวมอยู่ในชื่อแพ็กเกจ NuGet และเนมสเปซของบริการ

   Google.Apis.Dfareporting.v5

2. แสดงโดยใช้พร็อพเพอร์ตี้สาธารณะของ DfareportingService

   Console.WriteLine(DfareportingService.Version);

Java

ข้อมูลเวอร์ชันของไลบรารีของไคลเอ็นต์ Google API สำหรับ Java จะแสดงในตำแหน่งต่อไปนี้

1. ระบุใน Maven artifactId

   <dependency> <groupId>com.google.apis</groupId>
   <artifactId>google-api-services-dfareporting</artifactId>
   <version>v5-rev20260213-2.0.0</version>
   </dependency>

2. รวมอยู่ในชื่อไฟล์ JAR

   google-api-services-dfareporting-v5-rev20260213-2.0.0.jar

3. แสดงโดยใช้พร็อพเพอร์ตี้สาธารณะของ Dfareporting

   System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);

PHP

ข้อมูลเวอร์ชันของไลบรารีของไคลเอ็นต์ Google API สำหรับ PHP จะแสดงโดยใช้พร็อพเพอร์ตี้สาธารณะ ของ Google_Service_Dfareporting

$service = new Google_Service_Dfareporting($client) print
$service->version;

Python

ไลบรารีของไคลเอ็นต์ Google API สำหรับ Python (v1/v2) ไม่ได้กำหนดเวอร์ชัน เวอร์ชัน API ที่จะใช้ ระบุเป็นอาร์กิวเมนต์ในเครื่องมือสร้างการค้นพบ

discovery.build('dfareporting', 'v5', http=http)

Ruby

ไลบรารีของไคลเอ็นต์ Google API สำหรับ Ruby เวอร์ชันที่ต่ำกว่า 0.9 จะไม่มีการกำหนดเวอร์ชัน เวอร์ชัน API ที่จะใช้ จะระบุเป็นอาร์กิวเมนต์ในตัวสร้างบริการ

service = Google::APIClient::Service.new("dfareporting", "v5", { :application_name => "My application",
:application_version => '1.0.0', :authorization => authorization } )

สำหรับไลบรารีของไคลเอ็นต์ Google API สำหรับ Ruby เวอร์ชัน >= 0.9 ระบบจะแสดงเวอร์ชันในเนมสเปซของบริการ

Google.Apis.DfareportingV5

ขั้นตอนที่ 2: ตรวจสอบสถานะของเวอร์ชัน

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

หากเวอร์ชันของคุณแสดงอยู่ในรายการ ให้ตรวจสอบคอลัมน์วันที่เลิกใช้งานและวันที่สิ้นสุดการสนับสนุน

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

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

ขั้นตอนที่ 3: อัปเกรดเวอร์ชัน

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

เครื่องมือแก้ไข Apps Script แบบใหม่

Google Apps Script รองรับ Campaign Manager 360 API ทุกเวอร์ชัน และช่วยให้คุณ เลือกเวอร์ชันที่จะใช้ในแต่ละสคริปต์ได้ วิธีเปลี่ยนเวอร์ชันที่สคริปต์หนึ่งๆ ใช้

1. จากโปรแกรมแก้ไข Apps Script ให้คลิกเพิ่มบริการ
2. ค้นหา Campaign Manager 360 API ในรายการบริการที่พร้อมใช้งาน
3. เปลี่ยนเวอร์ชัน Campaign Manager 360 API โดยใช้เมนูแบบเลื่อนลงของเวอร์ชัน
4. คลิกเพิ่มเพื่อบันทึกการเปลี่ยนแปลง

เครื่องมือแก้ไข Apps Script เวอร์ชันเดิม

Google Apps Script รองรับ Campaign Manager 360 API ทุกเวอร์ชัน และช่วยให้คุณ เลือกเวอร์ชันที่จะใช้ในแต่ละสคริปต์ได้ วิธีเปลี่ยนเวอร์ชันที่สคริปต์หนึ่งๆ ใช้

1. จากโปรแกรมแก้ไข Apps Script ให้ไปที่ทรัพยากร > บริการขั้นสูงของ Google
2. ค้นหา Campaign Manager 360 API ในรายการบริการที่พร้อมใช้งาน
3. เปลี่ยนเวอร์ชัน Campaign Manager 360 API โดยใช้เมนูแบบเลื่อนลงของเวอร์ชัน
4. คลิกตกลงเพื่อบันทึกการเปลี่ยนแปลงของคุณ

C#

ไลบรารีของไคลเอ็นต์ Google API สำหรับ .NET มีบิลด์แยกต่างหากสำหรับ API ของ Campaign Manager 360 แต่ละเวอร์ชัน ซึ่งจัดจำหน่ายผ่าน NuGet อัปเดตเป็นเวอร์ชันของไลบรารีไคลเอ็นต์ ที่สอดคล้องกับเวอร์ชัน API ที่คุณต้องการใช้

ดูวิธีการติดตั้งโดยละเอียดหรือตัวเลือกการดาวน์โหลดอื่นได้ในเอกสารประกอบของไลบรารีของไคลเอ็นต์

Java

ไลบรารีของไคลเอ็นต์ Google API สำหรับ Java มีบิลด์แยกต่างหากสำหรับ API ของ Campaign Manager 360 แต่ละเวอร์ชัน ซึ่งจัดจำหน่ายผ่าน Maven อัปเดตเป็นเวอร์ชันของไลบรารีไคลเอ็นต์ ที่สอดคล้องกับเวอร์ชัน API ที่คุณต้องการใช้

ดูวิธีการติดตั้งโดยละเอียดหรือตัวเลือกการดาวน์โหลดอื่นได้ในเอกสารประกอบของไลบรารีของไคลเอ็นต์

PHP

ไลบรารีของไคลเอ็นต์ Google API สำหรับ PHP มีบิลด์แยกต่างหากสำหรับ API ของ Campaign Manager 360 แต่ละเวอร์ชัน ซึ่งจัดจำหน่ายผ่าน Packagist อัปเดตเป็นเวอร์ชันของ ไลบรารีของไคลเอ็นต์ที่สอดคล้องกับเวอร์ชัน API ที่คุณต้องการใช้

ดูวิธีการติดตั้งโดยละเอียดหรือตัวเลือกการดาวน์โหลดอื่นได้ในเอกสารประกอบของไลบรารีของไคลเอ็นต์

Python

การสร้างไลบรารีของไคลเอ็นต์ Google API สำหรับ Python (v1/v2) ทุกครั้งจะรองรับ Campaign Manager 360 API ทุกเวอร์ชัน หากต้องการย้ายข้อมูลไปยัง Campaign Manager 360 API เวอร์ชันใหม่ ให้อัปเดต สตริงเวอร์ชันที่ส่งเป็นอาร์กิวเมนต์ไปยังเครื่องมือสร้างการค้นหา

discovery.build('dfareporting', 'v5', http=http)

ดูวิธีการติดตั้งโดยละเอียดหรือตัวเลือกการดาวน์โหลดอื่นๆ ได้ในเอกสารประกอบของไลบรารีของไคลเอ็นต์

Ruby

ไลบรารีของไคลเอ็นต์ Google API สำหรับ Ruby เวอร์ชัน 0.8 และต่ำกว่ารองรับ Campaign Manager 360 API ทุกเวอร์ชัน หากต้องการย้ายข้อมูลไปยัง Campaign Manager 360 API เวอร์ชันใหม่ ให้อัปเดตสตริงเวอร์ชันที่ส่งเป็นอาร์กิวเมนต์ไปยังตัวสร้างบริการ

service = Google::APIClient::Service.new("dfareporting", "v5",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)

ไลบรารีของไคลเอ็นต์ Google API สำหรับ Ruby v0.9 ขึ้นไปมีบิลด์แยกต่างหากสำหรับ Campaign Manager 360 API แต่ละเวอร์ชัน ซึ่งจัดจำหน่ายผ่าน RubyGems อัปเดตเป็นเวอร์ชันของ ไลบรารีของไคลเอ็นต์ที่สอดคล้องกับเวอร์ชัน API ที่คุณต้องการใช้ ดูวิธีการติดตั้งโดยละเอียดหรือตัวเลือกการดาวน์โหลดอื่นได้ในเอกสารประกอบของไลบรารีของไคลเอ็นต์

REST

หากเรียกใช้ API โดยตรงโดยใช้ HTTPS ให้อัปเดตปลายทางสำหรับคำขอเพื่อใช้หมายเลขเวอร์ชัน API ใหม่

ตัวอย่างเช่น เมื่อย้ายข้อมูลจาก v4 ไปยัง v5 คุณจะต้องเปลี่ยน URL ฐาน จาก

https://dfareporting.googleapis.com/dfareporting/v4/...

ถึง:

https://dfareporting.googleapis.com/dfareporting/v5/...

ขั้นตอนที่ 4: ความแตกต่างของเวอร์ชันที่อยู่

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

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

• ฟีเจอร์ใหม่: ฟังก์ชันที่เพิ่มเข้ามาใหม่ ซึ่งไม่จำเป็นต้องมีการเปลี่ยนแปลงโค้ดสำหรับการย้ายข้อมูล
• การหยุดให้บริการ: ฟังก์ชันการทำงานที่นำออกจาก API เราจะระบุฟังก์ชันการทำงานทดแทน เมื่อพร้อมให้บริการ
• ปัญหาที่ทราบ: การแก้ไขฟังก์ชันการทำงานที่มีอยู่ เช่น การเปลี่ยนชื่อฟิลด์หรือเมธอด หรือการเปลี่ยนตรรกะการตรวจสอบ

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

ติดตามข้อมูลอัปเดต

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