มีหลายกรณีที่คุณอาจพบข้อผิดพลาดเมื่อทำงานกับ API ของ Display & Video 360 ซึ่งอาจเกี่ยวข้องกับข้อบกพร่องในโค้ด ข้อมูลจากผู้ใช้ที่ไม่ถูกต้อง หรือปัญหาเกี่ยวกับตัว API เอง ไม่ว่าเหตุผลใดก็ตาม การรู้วิธีแก้ปัญหาข้อผิดพลาดก็เป็นส่วนสำคัญของกระบวนการพัฒนา คู่มือนี้จะแสดงเคล็ดลับเกี่ยวกับแนวทางปฏิบัติแนะนำในการเริ่มต้นใช้งาน
การตรวจสอบข้อมูลเบื้องต้น
- อ่านคู่มือข้อกำหนดเบื้องต้น ตรวจสอบว่าคุณมีสิทธิ์เข้าถึง Display & Video 360 และโปรเจ็กต์ API ที่กำหนดค่าอย่างถูกต้อง
- หากการตอบกลับของคุณมีข้อผิดพลาด HTTP โปรดอ่านคำอธิบายโดยละเอียดและตรวจสอบว่าคำขอส่งไปยัง API และบริการที่ถูกต้อง
- อ่านคู่มือการให้สิทธิ์ ตรวจสอบว่าคำขอมีข้อมูลเข้าสู่ระบบ OAuth 2.0 ที่จำเป็น
ตรวจสอบว่าคุณใช้ข้อมูลเข้าสู่ระบบที่ถูกต้อง ดูรายละเอียดเกี่ยวกับการสร้างข้อมูลเข้าสู่ระบบสำหรับการตรวจสอบสิทธิ์ได้ในคู่มือการตั้งค่าแอปพลิเคชัน นอกจากนี้ คุณยังส่งโทเค็นเพื่อการเข้าถึงไปยังปลายทางTokeninfo ของ Google OAuth2 API ได้เพื่อยืนยันว่าออกโทเค็นให้กับโปรเจ็กต์ API ที่ถูกต้องและได้รับอนุญาตสําหรับขอบเขตที่ถูกต้องแล้ว
POST https://www.googleapis.com/oauth2/v2/tokeninfo?access_token={YOUR_ACCESS_TOKEN} 200 OK { "issued_to": "{API_PROJECT_CLIENT_ID}", "audience": "...", "scope": "{API_SCOPES}", "expires_in": ... }
การทำความเข้าใจข้อผิดพลาด
เมื่อ API พบข้อผิดพลาด โดยปกติแล้ว API นี้จะส่งคืนการตอบสนอง JSON ที่มีออบเจ็กต์ error ออบเจ็กต์นี้ให้บริบทเพิ่มเติมเกี่ยวกับข้อผิดพลาดเฉพาะที่พบ
{
"error": {
"code": 404,
"message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
"status": "NOT_FOUND"
}
}
โดยปกติแล้วเนื้อหาของออบเจ็กต์ error จะมีข้อมูลเพียงพอที่จะช่วยให้คุณระบุข้อผิดพลาดที่เกิดขึ้นได้ หากไม่เป็นเช่นนั้น คุณอาจต้องทำการวิจัยเพิ่มเติมเพื่อค้นหาความหมายของข้อผิดพลาด
การค้นคว้าข้อผิดพลาด
โปรดดูหัวข้อข้อผิดพลาดที่พบบ่อยซึ่งมีรายละเอียดสำหรับข้อผิดพลาดบางส่วนที่พบได้บ่อยที่สุด
หากข้อผิดพลาดไม่ครอบคลุมอยู่ในส่วนข้อผิดพลาดที่พบบ่อย โปรดดูเอกสารอ้างอิงและลองค้นหารหัสข้อผิดพลาด สถานะ และข้อความ
หากคุณพบข้อผิดพลาดใดๆ ที่ไม่ได้บันทึกไว้ โปรดแจ้งให้เราทราบ
ระบุต้นตอ
ถึงตอนนี้ คุณได้ระบุข้อผิดพลาดและเข้าใจความหมายของข้อผิดพลาดแล้ว หากไม่ ให้กลับไปที่การทำความเข้าใจข้อผิดพลาด หรือข้ามไปที่รับความช่วยเหลือหากคุณเชื่อว่าพบข้อผิดพลาดใน API ที่คุณแก้ไขด้วยตนเองไม่ได้
คุณต้องระบุสาเหตุก่อน จึงจะแก้ไขข้อผิดพลาดได้ ซึ่งมักจะเป็นข้อบกพร่องในโค้ดหรือค่าที่ป้อนไม่ถูกต้อง
หากต้องการตรวจสอบว่าปัญหาเกี่ยวข้องกับข้อบกพร่องในโค้ดหรือไม่ คุณควรตรวจสอบก่อนว่าโค้ดทำงานได้ตามที่ต้องการ ในขั้นแรก ให้พิจารณาตรวจสอบส่วนของโค้ดที่ทำให้เกิดคำขอที่ไม่สำเร็จเพื่อตรวจหาปัญหาที่ชัดเจน ในบางกรณีอาจจำเป็นต้องใช้เครื่องมือแก้ไขข้อบกพร่องเพื่อดำเนินการกับโค้ดทีละบรรทัดเพื่อให้แน่ใจว่าทำงานได้อย่างถูกต้อง
การตรวจสอบคำขอ HTTP เป็นอีกวิธีที่มีประโยชน์ในการระบุข้อบกพร่องที่อาจเกิดขึ้น รวมถึงกรณีของข้อมูลที่ไม่ถูกต้อง ไลบรารีของไคลเอ็นต์อย่างเป็นทางการหลายรายการสามารถกำหนดค่าให้บันทึกคำขอและการตอบกลับ HTTP ได้ โปรดอ่านเอกสารสำหรับไลบรารีที่คุณต้องการสำหรับรายละเอียดเพิ่มเติม พร็อกซี HTTP เช่น Charles, Squid หรือ Fiddler ยังใช้เพื่อเก็บบันทึกคำขอและการตอบกลับได้ด้วย เมื่อได้บันทึกเหล่านี้แล้ว ให้ตรวจสอบเพื่อให้แน่ใจว่าค่าพารามิเตอร์ของคำขอที่ระบุโดยแอปพลิเคชันถูกต้องและตรงกับสิ่งที่คุณคาดหวัง
เมื่อคุณระบุข้อบกพร่องหรืออินพุตที่ไม่ถูกต้องซึ่งทำให้เกิดข้อผิดพลาดแล้ว หวังว่าปัญหานี้จะได้รับการแก้ไข ถ้าคุณคิดไม่ออกหรือไม่แน่ใจว่าจะแก้ปัญหาอย่างไรได้ดีที่สุด แต่คุณสามารถใช้ข้อมูลที่รวบรวมได้จนถึงตอนนี้ในการขอความช่วยเหลือ
การขอความช่วยเหลือ
หากแก้ไขข้อผิดพลาดด้วยตนเองไม่ได้ โปรดติดต่อทีมสนับสนุนผ่านแบบฟอร์มนี้ในศูนย์ช่วยเหลือของ Display & Video 360
เมื่อกรอกแบบฟอร์มนี้ คุณควรระบุข้อมูลเกี่ยวกับปัญหาที่คุณพบและขั้นตอนการแก้ปัญหาที่คุณได้ดำเนินการไปแล้วให้มากที่สุด ข้อมูลที่เป็นประโยชน์ที่จะรวม:
- บันทึกคำขอ HTTP และการตอบกลับ ตรวจสอบให้แน่ใจว่าได้ปกปิดข้อมูลที่ละเอียดอ่อน เช่น โทเค็นเพื่อการเข้าถึง OAuth 2.0 ที่อยู่อีเมล ฯลฯ
- ข้อมูลโค้ด หากคุณสามารถแยกปัญหาออกเป็นส่วนใดส่วนหนึ่งของโค้ดได้ หรือสงสัยว่าปัญหาเกิดจากภาษาเฉพาะ ให้ใส่ตัวอย่างสั้นๆ เพื่อแสดงให้เห็นสิ่งที่คุณทำอยู่
- ข้อมูลเพิ่มเติม เช่น เวอร์ชันรันไทม์/ตัวตีความและแพลตฟอร์ม ซึ่งอาจเป็นประโยชน์กับคนอื่นๆ ที่พยายามทำให้เกิดปัญหาซ้ำ
การแก้ปัญหา
เมื่อระบุสาเหตุของปัญหาและคิดหาวิธีได้แล้ว ก็ถึงเวลาแก้ไข หากเป็นไปได้ ให้ทดสอบการแก้ไขในสภาพแวดล้อมที่มีการควบคุม (เช่น พาร์ทเนอร์หรือผู้ลงโฆษณาที่กําหนดค่าไว้สําหรับการทดสอบโดยเฉพาะ) กับช่วงของอินพุตทั้งที่ดีและไม่ดีก่อนติดตั้งใช้งานในเวอร์ชันที่ใช้งานจริง