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

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

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

ขั้นตอนที่ 1: ตรวจสอบเวอร์ชันที่ใช้อยู่

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

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

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

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

เครื่องมือแก้ไข Apps Script เดิม

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

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

C#

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

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

   Google.Apis.Dfareporting.v3_4

2. เปิดเผยผ่านทรัพย์สินสาธารณะของ DfareportingService

   Console.WriteLine(DfareportingService.Version);

Java

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

1. ระบุไว้ใน ArtifactId ของ Maven

   <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 ไม่มีเวอร์ชัน ระบบจะระบุเวอร์ชัน API ที่จะใช้เป็นอาร์กิวเมนต์ให้กับเครื่องมือสร้าง Discovery

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: กําหนดสถานะของเวอร์ชัน

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

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

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

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

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

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

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

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

เครื่องมือแก้ไข Apps Script เดิม

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

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

C#

ไลบรารีของไคลเอ็นต์ Google API สําหรับ .NET มีบิลด์แยกต่างหากสําหรับ Campaign Manager 360 API แต่ละเวอร์ชันซึ่งจัดจําหน่ายผ่าน Nuget

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

Java

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

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

PHP

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

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

Python

ทุกไลบรารีของไคลเอ็นต์ Google API สําหรับ Python รองรับ API ของ Campaign Manager 360 ทุกเวอร์ชัน เพียงอัปเดตสตริงเวอร์ชันที่กําลังส่งเป็นอาร์กิวเมนต์ไปยังเครื่องมือสร้าง Discovery ดังนี้

discovery.build('dfareporting', 'v3.4', http=http)

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

Ruby

ไลบรารีของไคลเอ็นต์ Google API สําหรับ Ruby v0.8 หรือต่ํากว่ารองรับ API ของ Campaign Manager 360 ทุกเวอร์ชัน เพียงอัปเดตสตริงเวอร์ชันที่กําลังส่งเป็นอาร์กิวเมนต์ไปยังเครื่องมือสร้างบริการ ดังนี้

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

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

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

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

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

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

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

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

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

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

• บล็อกนักพัฒนาซอฟต์แวร์ของ Google Ads (สมัครรับการแจ้งเตือนทางอีเมล)
• ฟอรัม API ของ Campaign Manager 360

เราขอแนะนําให้คุณติดตามช่องเหล่านี้อย่างน้อย 1 ช่องเพื่อติดตามข่าวสารล่าสุดเกี่ยวกับ API