วิธีใช้ CSS API มีดังนี้
สิทธิ์
หากต้องการใช้ CSS API คุณต้องกำหนดค่าสิทธิ์ใน 2 ที่ ได้แก่ Google Cloud และ CSS Center
Google Cloud IAM:
- สร้างบัญชีบริการในคอนโซล Google Cloud ทําตามวิธีการเดียวกับ Content API เพื่อสร้างและดาวน์โหลดไฟล์ข้อมูลเข้าสู่ระบบ JSON ขั้นตอนนี้ จะตรวจสอบสิทธิ์บัญชีบริการของคุณในฐานะเอนทิตี Google Cloud ที่ถูกต้อง
- หากใช้การเข้าถึง REST โดยตรงหรือไลบรารีของไคลเอ็นต์ Google API คุณจะต้องมีคีย์ API ที่สร้างจาก Google Cloud Console ด้วย
CSS Center:
- อีเมลของบัญชีบริการ (เช่น
your-service-account-name@your-project-id.iam.gserviceaccount.com
) ต้องได้รับการเพิ่มเป็นผู้ใช้ที่มีสิทธิ์เข้าถึงระดับผู้ดูแลระบบในบัญชี CSS Center ขั้นตอนนี้จะให้สิทธิ์บัญชีบริการในการเข้าถึงและจัดการ ข้อมูล CSS Center - คุณให้สิทธิ์เข้าถึงได้ที่ระดับกลุ่ม CSS (สำหรับการเข้าถึงโดเมนทั้งหมด) หรือบัญชีโดเมน CSS ที่เฉพาะเจาะจง สำหรับการเข้าถึง API การให้สิทธิ์เข้าถึงที่ ระดับกลุ่ม CSS เป็นเรื่องปกติ
- วิธีเพิ่มบัญชีบริการ
- ลงชื่อเข้าใช้ CSS Center ด้วยผู้ใช้ที่ดูแลระบบ
- ไปที่การเข้าถึงบัญชี (ใต้ไอคอนรูปเฟือง ⚙️)
- คลิก + เพิ่มผู้ใช้ แล้วป้อนอีเมลของบัญชีบริการ
- ตั้งค่าระดับการเข้าถึงเป็นผู้ดูแลระบบ
- สิทธิ์อาจใช้เวลาถึง 30 นาทีจึงจะมีผล หากพบ ข้อผิดพลาดเกี่ยวกับสิทธิ์ โปรดลองอีกครั้งในภายหลัง
- อีเมลของบัญชีบริการ (เช่น
ขอบเขตการตรวจสอบสิทธิ์:
ขอบเขต OAuth 2.0 ที่จำเป็นสำหรับ CSS API คือ
https://www.googleapis.com/auth/content
ตรวจสอบว่าแอปพลิเคชันของคุณขอขอบเขตนี้เมื่อตรวจสอบสิทธิ์
เปิดใช้ CSS API
หากต้องการใช้ CSS API คุณต้องเปิดใช้ในโปรเจ็กต์ Google Cloud คุณดูไลบรารีได้ที่ https://console.cloud.google.com/apis/library/css.googleapis.com
เริ่มเขียนโปรแกรม
CSS API มีตัวอย่างโค้ดและไลบรารีของไคลเอ็นต์ที่จะช่วยให้คุณเริ่มต้นใช้งานได้ นอกจากนี้ เรายังมีหน้าแนวทางปฏิบัติแนะนำด้วย
ส่งคำขอ
ส่งคำขอไปยัง URL ในรูปแบบต่อไปนี้
https://css.googleapis.com/{version}/{resource name}:{method}…
โดยที่ {resource name}
คือชื่อของทรัพยากร
ที่การเรียกของคุณส่งผลกระทบ
ตัวอย่างเช่น วิธีลบทรัพยากรด้วย gRPC มีดังนี้
https://css.googleapis.com/v1/{resource name}:delete
วิธีลบทรัพยากรด้วย REST
DELETE https://css.googleapis.com/v1/{resource name}
ดูรายละเอียดเพิ่มเติมเกี่ยวกับบริการที่เฉพาะเจาะจงได้ในเอกสารอ้างอิงของ CSS API
ใช้ gRPC หรือ REST
CSS API รองรับ gRPC และ REST คุณเรียกใช้ CSS API ได้ 2 วิธี ดังนี้
gRPC (แนะนำ) | REST |
---|---|
|
|
รับความช่วยเหลือ
โปรดติดต่อตัวแทนของ Google เพื่อรับการสนับสนุน หรือใช้แบบฟอร์มความคิดเห็นเพื่อรายงานปัญหา
หากพบปัญหาและต้องการแสดงความคิดเห็นเพิ่มเติม ให้ทำดังนี้
แสดงความคิดเห็น
หากต้องการส่งความคิดเห็น ให้ส่งข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้
- ฟีเจอร์ API: ส่งแบบฟอร์ม ความคิดเห็น
- เอกสารประกอบ: ใช้การให้คะแนนด้วยนิ้วโป้งในหน้าและปุ่มส่งความคิดเห็น
- ตัวอย่างและไลบรารี: ใช้ปุ่มปัญหาใหม่ใน GitHub
หากต้องการแสดงความคิดเห็นทั่วไปหลังจากดำเนินงานแต่ละอย่าง ให้ใช้แบบฟอร์ม ความคิดเห็น