ตารางต่อไปนี้สรุปข้อมูลเข้าสู่ระบบที่แอปต้องจัดการ ดูข้อมูลเพิ่มเติมเกี่ยวกับประเภทแอปได้ที่เอกสารประกอบเกี่ยวกับ OAuth 2.0 ของ Google Identity
| ขั้นตอนการตรวจสอบสิทธิ์ | ข้อมูลเข้าสู่ระบบ | ประเภทข้อมูลเข้าสู่ระบบ | วัตถุประสงค์ |
|---|---|---|---|
|
เว็บแอป JavaScript แอป Android |
รหัสไคลเอ็นต์ OAuth | ข้อมูลเข้าสู่ระบบของแอป | ระบุแอปแบบไม่ซ้ำกันในระหว่างขั้นตอน OAuth |
| โทเค็นเพื่อการเข้าถึงและโทเค็นการรีเฟรช | ข้อมูลรับรองของผู้ใช้ | แสดงถึงการให้สิทธิ์ของผู้ใช้เพื่ออนุญาตให้แอปเข้าถึงบัญชี Google Ads ในนามของผู้ใช้ | |
|
เว็บแอปฝั่งเซิร์ฟเวอร์ แอปบนเดสก์ท็อปและ iOS แอปทีวีและอุปกรณ์ |
รหัสไคลเอ็นต์ OAuth และรหัสลับไคลเอ็นต์ | ข้อมูลเข้าสู่ระบบของแอป | ระบุแอปแบบไม่ซ้ำกันในระหว่างขั้นตอน OAuth |
| โทเค็นเพื่อการเข้าถึงและโทเค็นการรีเฟรช | ข้อมูลรับรองของผู้ใช้ | แสดงถึงการให้สิทธิ์ของผู้ใช้เพื่ออนุญาตให้แอปเข้าถึงบัญชี Google Ads ในนามของผู้ใช้ | |
| บัญชีบริการ | คีย์บัญชีบริการ OAuth | ข้อมูลเข้าสู่ระบบของแอป | ใช้สำหรับการลงชื่อในคำขอ OAuth |
| โทเค็นเพื่อการเข้าถึงของบัญชีบริการ | ข้อมูลรับรองของผู้ใช้ | แสดงถึงการให้สิทธิ์ของบัญชีบริการเมื่อผู้ใช้แชร์บัญชี Google Ads กับบัญชีบริการ |
มีหลายประเด็นที่ควรพิจารณาเมื่อจัดการข้อมูลเข้าสู่ระบบสำหรับแอป Google Ads API
จัดการข้อมูลเข้าสู่ระบบของแอปอย่างปลอดภัย
ข้อมูลเข้าสู่ระบบของแอปหมายถึงการตั้งค่าที่เฉพาะเจาะจงสำหรับแอปของคุณและไม่แตกต่างกันไปตามผู้ใช้แต่ละราย โปรดดูแลข้อมูลเข้าสู่ระบบของแอป OAuth อย่างระมัดระวัง เนื่องจากข้อมูลดังกล่าวจะอนุญาตให้ทุกคนที่ครอบครองข้อมูลใช้ข้อมูลประจำตัวของแอปเพื่อเข้าถึงข้อมูลผู้ใช้ได้ เก็บข้อมูลเข้าสู่ระบบของแอป OAuth ไว้ในที่ปลอดภัยและปกป้องข้อมูลดังกล่าวเช่นเดียวกับที่คุณทำกับรหัสผ่าน หากเป็นไปได้ ให้ใช้เครื่องมือจัดการข้อมูลลับ เช่น Google Cloud Secret Manager เพื่อจัดเก็บข้อมูลเข้าสู่ระบบของแอป คุณต้องไม่คอมมิตข้อมูลเข้าสู่ระบบของไคลเอ็นต์ไปยังที่เก็บโค้ดที่เผยแพร่ต่อสาธารณะ เราขอแนะนำอย่างยิ่งให้หลีกเลี่ยงการคอมมิตข้อมูลเข้าสู่ที่เก็บโค้ด
จัดการข้อมูลเข้าสู่ระบบของผู้ใช้อย่างปลอดภัย
ข้อมูลเข้าสู่ระบบของผู้ใช้หมายถึงโทเค็น OAuth ที่แสดงถึงการให้สิทธิ์ของผู้ใช้ ผู้ใช้ที่ให้สิทธิ์คุณในการดำเนินการและเข้าถึงข้อมูลในนามของตนได้มอบความไว้วางใจให้คุณ ไม่ว่าจะโดยตรงด้วยการตรวจสอบสิทธิ์แอปของคุณ หรือโดยอ้อมด้วยการแชร์บัญชี Google Ads กับบัญชีบริการของคุณ อย่าส่งโทเค็นในรูปแบบข้อความธรรมดา และจัดเก็บโทเค็นที่เข้ารหัสไว้เสมอเมื่อไม่มีการเคลื่อนไหว เพื่อเพิ่มการปกป้องอีกชั้นหนึ่งในกรณีที่เกิดการละเมิดข้อมูล เพิกถอนโทเค็นหรือสิทธิ์ของบัญชีบริการเมื่อคุณไม่ต้องการเข้าถึงบัญชีของผู้ใช้อีกต่อไป หลังจากเพิกถอนโทเค็นแล้ว ให้ลบโทเค็นออกจากแอปพลิเคชันหรือระบบอย่างถาวร
จัดการการเพิกถอนและการหมดอายุของโทเค็นการรีเฟรช
หากคุณใช้ขั้นตอนการตรวจสอบสิทธิ์ผู้ใช้ โปรดทราบว่าโทเค็นการรีเฟรชอาจใช้ไม่ได้ทุกเมื่อ ตัวอย่างเช่น หากคุณใช้ขั้นตอนการตรวจสอบสิทธิ์แบบผู้ใช้หลายคนหนึ่งเครื่อง ผู้ใช้อาจเลือกเพิกถอนสิทธิ์เข้าถึงแอปของคุณ แม้ว่าแอปที่ใช้ขั้นตอนการตรวจสอบสิทธิ์แบบผู้ใช้คนเดียวจะมีโอกาสได้รับผลกระทบน้อยกว่าในลักษณะนี้ แต่กระบวนการที่ออกแบบมาเพื่อปกป้องผู้ใช้ ไม่ว่าจะเป็นแบบดำเนินการด้วยตนเองหรือแบบอัตโนมัติ ก็ยังคงล้างโทเค็นการรีเฟรชได้ หรือโทเค็นการรีเฟรชอาจหมดอายุ หากแอปของคุณต้องการการแจ้งเตือนการเพิกถอนโทเค็นเพื่อมอบประสบการณ์ที่ดีแก่ผู้ใช้ คุณต้องผสานรวมกับบริการการป้องกันแบบครอบคลุมหลายบริการ
ใช้ข้อมูลเข้าสู่ระบบของผู้ใช้ซ้ำในคำขอ API
โทเค็นเพื่อการเข้าถึง OAuth มีอายุการใช้งานสั้นและจะหมดอายุหลังจากผ่านไป 1 ชั่วโมง หากคุณใช้ไลบรารีของไคลเอ็นต์ Google Ads API ไลบรารีจะจัดการการหมดอายุของโทเค็นเพื่อการเข้าถึงและรีเฟรชในลักษณะที่ปลอดภัยต่อชุดข้อความ สร้างออบเจ็กต์ไคลเอ็นต์ Google Ads API ด้วยข้อมูลเข้าสู่ระบบ OAuth ที่เหมาะสม และนำกลับมาใช้ซ้ำตลอดอายุการใช้งาน
หากคุณสร้างกลยุทธ์การรีเฟรชและการจัดการโทเค็นเพื่อการเข้าถึงของคุณเอง ให้ติดตามวันหมดอายุของโทเค็นเพื่อการเข้าถึงและใช้โทเค็นซ้ำขณะที่ยังใช้งานได้ เมื่อคุณขอรีเฟรชโทเค็น เซิร์ฟเวอร์การให้สิทธิ์จะแสดงโทเค็นเพื่อการเข้าถึงใหม่พร้อมกับอายุการใช้งานที่เหลือเป็นวินาที (expires_in) เราขอแนะนำให้รีเฟรชโทเค็นเพื่อการเข้าถึงในเชิงรุกหากเหลือเวลาไม่ถึง 5 นาทีก่อนหมดอายุ