การแยกความยินยอมใน Ads API

วันพฤหัสบดีที่ 20 กุมภาพันธ์ 2025

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

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

ใครบ้างที่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้
คุณจะได้รับผลกระทบจากการเปลี่ยนแปลงนี้หากตรงตามเงื่อนไขต่อไปนี้ทั้งหมด

1. แอปพลิเคชัน API ของคุณใช้โปรเจ็กต์คอนโซล Google Cloud ที่สร้างขึ้นก่อนปี 2019
2. แอปพลิเคชันของคุณใช้ขั้นตอนความยินยอมของผู้ใช้ OAuth 2.0 ซึ่งเป็นเวิร์กโฟลว์การตรวจสอบสิทธิ์ที่ผู้ใช้เข้าสู่ระบบด้วยบัญชี Google และให้สิทธิ์อย่างน้อย 1 รายการที่แอปพลิเคชันของคุณขอ
3. แอปพลิเคชันของคุณใช้ Google API มากกว่า 1 รายการ และ API รายการหนึ่งเป็น API ที่เกี่ยวข้องกับ Google Ads ซึ่งแสดงอยู่ด้านล่าง

ใครบ้างที่ไม่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้

• โทเค็นการรีเฟรชที่มีอยู่: การเปลี่ยนแปลงนี้จะไม่ส่งผลต่อการตรวจสอบสิทธิ์ผู้ใช้ที่คุณมีอยู่แล้ว โทเค็นการรีเฟรชที่มีอยู่จะยังคงทำงานต่อไปโดยไม่มีการเปลี่ยนแปลงหรือการตรวจสอบสิทธิ์อีกครั้ง
• แอปพลิเคชันที่มีขอบเขตเดียว: หากแอปพลิเคชันใช้ขอบเขต Google API เพียงขอบเขตเดียว แอปพลิเคชันจะไม่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้ เนื่องจากไม่มีขอบเขต OAuth หลายขอบเขตที่ต้องแยกออกจากกัน
• แอปพลิเคชันผู้ใช้รายเดียว/แอปพลิเคชันที่ตรวจสอบสิทธิ์ด้วยตนเอง: แอปพลิเคชันของคุณไม่ได้ใช้ขั้นตอนการตรวจสอบสิทธิ์ผู้ใช้ OAuth ที่ชัดเจน แต่คุณจะใช้สคริปต์การตรวจสอบสิทธิ์ด้วยตนเอง เช่น GenerateUserCredentials, gcloud CLI หรือ OAuth Playground เพื่อตรวจสอบสิทธิ์ผู้ใช้ แล้วใช้ข้อมูลเข้าสู่ระบบเหล่านั้นเป็นระยะเวลานาน เนื่องจากคุณเลือกขอบเขตทั้งหมดที่แอปพลิเคชันต้องการขณะตรวจสอบสิทธิ์ แอปพลิเคชันของคุณจึงไม่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้
• บัญชีบริการ: หากแอปพลิเคชันใช้บัญชีบริการเพื่อตรวจสอบสิทธิ์การเรียก API คุณจะไม่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้

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

1. ขอรายการขอบเขต OAuth ที่ผู้ใช้ให้ความยินยอมโดยรวมพารามิเตอร์ include_granted_scopes ไว้ในขั้นตอน OAuth
2. ตรวจสอบรายการขอบเขต OAuth จริงที่ผู้ใช้ให้ความยินยอมในการตอบกลับ OAuth
3. ใช้การให้สิทธิ์แบบเพิ่มขึ้นในแอปพลิเคชัน

อ่านคู่มือความยินยอมแบบละเอียดของ OAuth เพื่อดูข้อกำหนดและแนวทางปฏิบัติแนะนำในการจัดการความยินยอมแบบละเอียด

ฉันจะทดสอบฟีเจอร์นี้ได้อย่างไร
คุณทดสอบฟีเจอร์นี้ได้ 2 วิธีดังนี้

1. สร้างโปรเจ็กต์ Google Cloud ใหม่: โปรเจ็กต์ Google Cloud ใหม่ได้เปิดใช้การแยกกลุ่มความยินยอม OAuth แล้ว คุณจึงสร้างโปรเจ็กต์ Google Cloud ใหม่และใช้เพื่อทดสอบแอปพลิเคชันได้
2. เปิดใช้การแยกการให้ความยินยอมในโปรเจ็กต์ที่มีอยู่: คุณสามารถตั้งค่าพารามิเตอร์ enable_granular_consent เป็น "จริง" ในคำขอการให้สิทธิ์ OAuth ได้

ขอบเขต API ใดบ้างที่ได้รับผลกระทบ
API ต่อไปนี้ที่เกี่ยวข้องกับ Google Ads จะได้รับผลกระทบจากการเปลี่ยนแปลงนี้

API	ขอบเขต OAuth
Google Ads API	https://adwords.google.com/api/adwords
Google Ad Manager API (SOAP API, เบต้า)	https://www.googleapis.com/auth/dfp https://www.googleapis.com/auth/admanager
Bid Manager API	https://www.googleapis.com/auth/doubleclickbidmanager
Content API for Shopping	https://www.googleapis.com/auth/content
Display and Video 360 API	https://www.googleapis.com/auth/display-video-mediaplanning https://www.googleapis.com/auth/display-video-user-management
AdMob API	https://www.googleapis.com/auth/admob.report https://www.googleapis.com/auth/admob.googlebidding.readwrite https://www.googleapis.com/auth/admob.monetization
AdSense for Platforms API	https://www.googleapis.com/auth/adsensehost https://www.googleapis.com/auth/adsense https://www.googleapis.com/auth/adsense.readonly
Google Analytics API	https://www.googleapis.com/auth/analytics https://www.googleapis.com/auth/analytics.readonly https://www.googleapis.com/auth/analytics.edit https://www.googleapis.com/auth/analytics.manage.users https://www.googleapis.com/auth/analytics.manage.users.readonly https://www.googleapis.com/auth/analytics.provision https://www.googleapis.com/auth/analytics.user.deletion
Campaign Manager 360 API	https://www.googleapis.com/auth/ddmconversions https://www.googleapis.com/auth/dfareporting https://www.googleapis.com/auth/dfatrafficking
Search Ads 360 API	https://www.googleapis.com/auth/doubleclicksearch
Google Tag Manager API	https://www.googleapis.com/auth/tagmanager.delete.containers https://www.googleapis.com/auth/tagmanager.edit.containers https://www.googleapis.com/auth/tagmanager.edit.containerversions https://www.googleapis.com/auth/tagmanager.manage.accounts https://www.googleapis.com/auth/tagmanager.manage.users https://www.googleapis.com/auth/tagmanager.publish https://www.googleapis.com/auth/tagmanager.readonly
Real-time Bidding API	https://www.googleapis.com/auth/realtime-bidding
Authorized Buyers Marketplace API	https://www.googleapis.com/auth/authorized-buyers-marketplace https://www.googleapis.com/auth/adexchange.buyer

วิธีรับความช่วยเหลือ
หากมีข้อสงสัยหรือต้องการความช่วยเหลือ โปรดติดต่อทีมสนับสนุนของ API ที่เกี่ยวข้องพร้อมคำถามของคุณ

 - Anash P. Oommen, ทีม Google Ads API

ป้ายกำกับ: authentication, oauth