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

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

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

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

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

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

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

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

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

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

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

C#

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

  1. รวมอยู่ในชื่อแพ็กเกจ NuGet และเนมสเปซของบริการ 
    Google.Apis.Dfareporting.v3_4
  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>v3.4-rev1-1.21.0</version>
</dependency>
  2. รวมอยู่ในชื่อไฟล์ JAR 
    google-api-services-dfareporting-v3.4-rev1-1.21.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', 'v3.4', http=http)

Ruby

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

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

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

Google.Apis.DfareportingV3_4

ขั้นตอนที่ 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 ที่คุณต้องการใช้

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

Java

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

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

PHP

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

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

Python

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

discovery.build('dfareporting', 'v3.4', http=http)
 ดูวิธีการติดตั้งโดยละเอียดหรือตัวเลือกการดาวน์โหลดอื่นๆ ได้ในเอกสารประกอบของไลบรารีไคลเอ็นต์

Ruby

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

service = Google::APIClient::Service.new("dfareporting", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)
 ไลบรารีของไคลเอ็นต์ Google API สำหรับ Ruby v0.9 ขึ้นไปมีบิลด์แยกต่างหากสำหรับ API ของ Campaign Manager 360 แต่ละเวอร์ชัน ซึ่งจัดจำหน่ายผ่าน RubyGems อัปเดตเป็นเวอร์ชันของ ไลบรารีของไคลเอ็นต์ที่สอดคล้องกับเวอร์ชัน API ที่คุณต้องการใช้ ดูวิธีการติดตั้งโดยละเอียดหรือตัวเลือกการดาวน์โหลดอื่นๆ ได้ในเอกสารประกอบของ Client Library

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 ก่อนใคร