API ขั้นสูง

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

ดูตัวอย่างที่แสดงวิธีใช้ API เหล่านี้ได้ที่หน้าข้อมูลโค้ด

API ขั้นสูงที่พร้อมใช้งาน

Google Analytics
หมายเหตุ: API ขั้นสูง Analytics ในกล่องโต้ตอบ API ขั้นสูงกำหนดเป้าหมายเป็น Universal Analytics v3 API ที่ปิดไปแล้ว และคำขอที่ส่งไปยัง API ดังกล่าวจะดำเนินการไม่สำเร็จ สคริปต์ Google Ads ไม่รองรับบริการขั้นสูง AnalyticsData หรือ AnalyticsAdmin ของ Google Analytics 4 หากต้องการค้นหาข้อมูล Google Analytics 4 จากสคริปต์ ให้ส่งคำขอ HTTPS ไปยัง Google Analytics Data API โดยใช้บริการ UrlFetchApp และ OAuth 2.0 นอกจากนี้ คุณยังลิงก์พร็อพเพอร์ตี้ Google Analytics 4 กับบัญชี Google Ads เพื่อแชร์ข้อมูล Conversion ของเว็บไซต์และแอปโดยตรงได้ด้วย ดูวิธีการตั้งค่าได้ที่คู่มือการตั้งค่า Analytics
Google BigQuery
คุณสามารถโหลดข้อมูลจำนวนมากลงใน Google Cloud Storage แล้วค้นหาข้อมูลนั้นโดยใช้ Google BigQuery ตัวอย่างเช่น คุณสามารถโหลดข้อมูลสภาพอากาศสาธารณะในช่วง 10 ปีที่ผ่านมา แล้วค้นหาอุณหภูมิเฉลี่ยของภูมิภาคในสคริปต์ที่ใช้ข้อมูลนั้นในการปรับราคาเสนอ อีกกรณีหนึ่งคือการคำนวณข้อมูลประสิทธิภาพของบัญชีในช่วงหลายปีที่ผ่านมา
Google ปฏิทิน
สคริปต์สามารถสร้างกิจกรรมสำหรับงานในอนาคต (เช่น เรียกใช้รายงานประสิทธิภาพสำหรับแคมเปญในอีก 2 สัปดาห์นับจากวันนี้) หรือดำเนินการตามรายการที่คุณสร้างไว้ในปฏิทิน (เช่น เปิดใช้แคมเปญในวันที่ที่เจาะจง)
Google สไลด์
สคริปต์สามารถส่งออกรายละเอียดหรือสถิติของแคมเปญไปยัง Google สไลด์เพื่อเผยแพร่ข้อมูลดังกล่าวในรูปแบบที่นำเสนอได้
Google Tasks
สคริปต์สามารถสร้างรายการช่วยเตือนสำหรับงานในอนาคต (เช่น เรียกใช้รายงานประสิทธิภาพสำหรับแคมเปญในอีก 2 สัปดาห์นับจากวันนี้) หรือดำเนินการตามรายการที่คุณสร้างไว้ในรายการช่วยเตือน (เช่น เปิดใช้แคมเปญในวันที่ที่เจาะจง)
Merchant API
สคริปต์ของคุณสามารถใช้ Merchant API เพื่ออัปโหลดและจัดการข้อมูลสินค้าที่แสดง รวมถึงจัดการบัญชี Google Merchant Center ได้ ในสคริปต์ วิธีนี้มีประโยชน์ในการตรวจสอบข้อมูลสินค้าที่แสดงและลิงก์สินค้าที่เฉพาะเจาะจงกับโฆษณาที่เฉพาะเจาะจง Merchant API มี API ย่อยที่เปิดใช้แยกกันได้ในกล่องโต้ตอบ API ขั้นสูง ดูข้อมูลเพิ่มเติมเกี่ยวกับการลิงก์บัญชี Google Merchant Center ได้ในคู่มือลงทะเบียนเป็นนักพัฒนาแอป
คอนเทนต์ช็อปปิ้ง
สคริปต์ของคุณสามารถใช้ Google Content API for Shopping เพื่ออัปโหลดและจัดการข้อมูลสินค้าที่แสดง รวมถึงจัดการบัญชี Google Merchant Center ได้ ในสคริปต์ ฟีเจอร์นี้มีประโยชน์ในการตรวจสอบข้อมูลสินค้าที่แสดงและลิงก์สินค้าที่เฉพาะเจาะจงกับโฆษณาที่เฉพาะเจาะจง หมายเหตุ: Content API for Shopping จะหยุดให้บริการในวันที่ 18 สิงหาคม 2026 โปรดใช้ Merchant API ซึ่งอธิบายไว้ในส่วนก่อนหน้าแทน
YouTube และข้อมูลวิเคราะห์ YouTube
คุณสามารถเรียกดูและอัปเดตวิดีโอ เพลย์ลิสต์ ฯลฯ รวมถึงข้อมูลประสิทธิภาพของวิดีโอเพื่อใช้ในการตัดสินใจเกี่ยวกับการเสนอราคาได้

เปิดใช้ API ขั้นสูง

หากต้องการดูว่า Google APIs ใดบ้างที่พร้อมใช้งานเป็น API ขั้นสูง ให้คลิก API ขั้นสูงในแถบเครื่องมือแก้ไขด้านบนเพื่อแสดงกล่องโต้ตอบ API ขั้นสูง เลือก API ที่ต้องการเปิดใช้

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

ข้อควรพิจารณาเพิ่มเติม

สิ่งที่ควรคำนึงถึงเมื่อทำงานกับ API ขั้นสูงมีดังนี้

แท็กเริ่มการทำงาน

เฉพาะผู้ใช้ที่สร้างสคริปต์ในบัญชีเท่านั้นที่เปลี่ยนทรัพยากร Dependency ของ API ขั้นสูงสําหรับสคริปต์นั้นได้

สิทธิ์

เมื่อเข้าถึง API ขั้นสูง สคริปต์จะใช้สิทธิ์ของผู้ใช้ที่ให้สิทธิ์สคริปต์ ผู้ใช้ที่ให้สิทธิ์ต้องมีสิทธิ์เข้าถึงข้อมูลทั้งหมดที่สคริปต์ต้องการ ตัวอย่างเช่น หากต้องการใช้ API ขั้นสูงของ BigQuery ผู้ใช้ที่ให้สิทธิ์ต้องมีสิทธิ์ที่จำเป็นสำหรับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ Google Cloud และชุดข้อมูล BigQuery เป้าหมาย

ข้อควรพิจารณาสำหรับสคริปต์ที่สร้างก่อนเดือนพฤษภาคม 2019

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

เปิดใช้ API ขั้นสูง

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

  1. คลิกปุ่ม Advanced APIs ในหน้าต่างกล่องโต้ตอบต่อไปนี้ ให้คลิกลิงก์ไปยังคอนโซล Google Cloud
  2. หากยังไม่ได้เลือกโปรเจ็กต์ ให้เลือกจากรายการแบบเลื่อนลง "โปรเจ็กต์"
  3. ค้นหา API ที่ต้องการใช้ในสคริปต์โดยป้อนชื่อ API ในแถบค้นหา
  4. เลือก API จากผลการค้นหา แล้วคลิกปุ่ม "เปิดใช้" ในหน้าถัดไป

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