เราเลิกใช้งาน Search Ads 360 Reporting API เวอร์ชันเก่าแล้ว ตอนนี้คุณสร้างรายงานได้โดยใช้ Search Ads 360 Reporting API เวอร์ชันใหม่

โปรดทราบว่า Search Ads 360 Conversion API จะไม่ได้รับผลกระทบและจะยังคงได้รับการรองรับต่อไป

หน้านี้ได้รับการแปลโดย Cloud Translation API

แอปแรกของคุณ: ข้อกำหนดเบื้องต้น

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

สร้างบัญชี Google และรับสิทธิ์ใช้ Search Ads 360

หากต้องการใช้ Search Ads 360 API คุณต้องมีบัญชี Google และสิทธิ์ที่เหมาะสมซึ่งมอบให้แก่บัญชีดังกล่าวจาก Search Ads 360

หากคุณยังไม่มีบัญชี Google โปรด สร้างขึ้น
ขอให้ผู้จัดการเอเจนซีของ Search Ads 360 สร้างผู้ใช้ Search Ads 360 สําหรับบัญชี Google ของคุณ

หากต้องการดาวน์โหลดรายงาน คุณต้องมีสิทธิ์ดูสำหรับผู้ลงโฆษณาที่คุณจะทํางานด้วย

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

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

เปิดใช้งานบริการ Conversion API

หากต้องการอัปโหลดข้อมูลเกี่ยวกับ Conversion ผู้ใช้ Search Ads 360 ที่มีสิทธิ์ผู้จัดการเอเจนซีต้องลงชื่อเข้าใช้ UI ของ Search Ads 360 และเปิดใช้งานบริการ Conversion API ดูวิธีการที่ศูนย์ช่วยเหลือของ Search Ads 360

สร้างโปรเจ็กต์คอนโซล Google API และข้อมูลเข้าสู่ระบบ OAuth สำหรับลูกค้า

เริ่ม เครื่องมือการตั้งค่าคอนโซล Google API
เครื่องมือการตั้งค่าจะแนะนำขั้นตอนการสร้างโปรเจ็กต์ (หรือใช้โปรเจ็กต์ที่มีอยู่) การเปิดใช้ Search Ads 360 API และสร้างข้อมูลเข้าสู่ระบบ OAuth 2.0
ในหน้าลงทะเบียนแอปพลิเคชัน ให้เลือกโปรเจ็กต์ที่มีอยู่หรือเลือกสร้างโปรเจ็กต์ แล้วคลิกดำเนินการต่อ
หลังจากคอนโซล Google API เปิดใช้ Search Ads 360 API แล้ว ให้คลิกปุ่มไปที่ข้อมูลเข้าสู่ระบบ
ในหน้าสร้างข้อมูลเข้าสู่ระบบ ให้ป้อนข้อมูลต่อไปนี้
- คุณกำลังใช้ API ใด: Search Ads 360 API
- คุณต้องการเข้าถึงข้อมูลใด ข้อมูลผู้ใช้
คลิกปุ่มถัดไป
ในตอนนี้ เครื่องมือตั้งค่าจะเสนอเพื่อช่วยคุณสร้างรหัสไคลเอ็นต์ OAuth 2.0
ทำตามขั้นตอนที่เหลือในเครื่องมือตั้งค่า

ติดตั้ง sa360Api.py

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

วิธีติดตั้งสคริปต์

ติดตั้ง Python 2.7
สคริปต์นี้ใช้กับ Python 3.x ไม่ได้
ติดตั้ง cURL
ดาวน์โหลด sa360Api.zip
ดึงข้อมูล sa360Api.py จาก sa360Api.zip
ทำให้ sa360Api.py เป็นไฟล์ปฏิบัติการ

ดูข้อมูลเบื้องต้นเกี่ยวกับ REST

การเรียก API ทำได้ 2 วิธีดังนี้

การใช้ไลบรารีของไคลเอ็นต์
ส่งคำขอ HTTP และแยกวิเคราะห์การตอบกลับ

หากตัดสินใจว่าจะไม่ใช้ไลบรารีไคลเอ็นต์ คุณจะต้องเข้าใจพื้นฐานของ REST

REST เป็นรูปแบบสถาปัตยกรรมซอฟต์แวร์ที่ให้แนวทางที่สะดวกและสอดคล้องกันในการขอและแก้ไขข้อมูล

คำว่า REST เป็นคำสั้นๆ ของ "Sentational State Transfer" ในบริบทของ Google API หมายถึงการใช้คํากริยา HTTP เพื่อดึงข้อมูลและแก้ไขการนําเสนอข้อมูลที่ Google จัดเก็บไว้

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

ใน RESTful API ของ Google ไคลเอ็นต์จะระบุการดำเนินการโดยใช้คำกริยา HTTP เช่น POST, GET, PUT หรือ DELETE โดยระบุทรัพยากรด้วย URI ที่ไม่ซ้ำกันทั่วโลกในรูปแบบต่อไปนี้

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

เนื่องจากทรัพยากร API ทั้งหมดมี URI ที่เข้าถึงได้ผ่าน HTTP ที่ไม่ซ้ำกัน REST จึงเปิดใช้การแคชข้อมูลและได้รับการเพิ่มประสิทธิภาพให้ทำงานร่วมกับโครงสร้างพื้นฐานแบบกระจายของเว็บ

คุณดูคำจำกัดความของเมธอดได้ในเอกสารประกอบของมาตรฐาน HTTP 1.1 ซึ่งมีประโยชน์เช่นกัน ซึ่งมีข้อกำหนดของ GET, POST, PUT และ DELETE

REST ใน Search Ads 360 API

การดำเนินการของ Search Ads 360 API จะจับคู่กับคำกริยา HTTP ของ REST โดยตรง

รูปแบบที่เฉพาะเจาะจงสําหรับ URI ของ Search Ads 360 API มีดังนี้

https://www.googleapis.com/doubleclicksearch/v2/resourcePath?parameters

ชุด URI แบบเต็มที่ใช้สำหรับการดำเนินการที่รองรับแต่ละรายการใน API จะสรุปไว้ในเอกสารอ้างอิง API

ดูข้อมูลเบื้องต้นเกี่ยวกับ JSON

หากใช้ REST คุณจะต้องใช้รูปแบบ JSON สําหรับเนื้อหาคำขอ คุณสามารถระบุให้คำตอบอยู่ในรูปแบบ JSON หรือ CSV

JSON (JavaScript Object Notation) เป็นรูปแบบข้อมูลทั่วไปที่ไม่ขึ้นอยู่กับภาษา ซึ่งมีการนำเสนอแบบข้อความอย่างง่ายของโครงสร้างข้อมูลที่กำหนดเอง สำหรับข้อมูลเพิ่มเติม โปรดดู json.org