เริ่มต้นใช้งาน CSS API

วิธีใช้ CSS API มีดังนี้

สิทธิ์

หากต้องการใช้ CSS API คุณต้องกำหนดค่าสิทธิ์ใน 2 ที่ ได้แก่ Google Cloud และ CSS Center

  1. Google Cloud IAM:

    • สร้างบัญชีบริการในคอนโซล Google Cloud ทําตามวิธีการเดียวกับ Content API เพื่อสร้างและดาวน์โหลดไฟล์ข้อมูลเข้าสู่ระบบ JSON ขั้นตอนนี้ จะตรวจสอบสิทธิ์บัญชีบริการของคุณในฐานะเอนทิตี Google Cloud ที่ถูกต้อง
    • หากใช้การเข้าถึง REST โดยตรงหรือไลบรารีของไคลเอ็นต์ Google API คุณจะต้องมีคีย์ API ที่สร้างจาก Google Cloud Console ด้วย

  2. 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
  1. สร้างเนื้อหาของคำขอเป็น Protocol Buffer
  2. ส่งเนื้อหาคำขอไปยังเซิร์ฟเวอร์ด้วย HTTP/2
  3. ยกเลิกการซีเรียลไลซ์การตอบกลับเป็นบัฟเฟอร์โปรโตคอล
  4. ตีความผลลัพธ์
  1. สร้างเนื้อหาของคำขอเป็นออบเจ็กต์ JSON
  2. ส่งไปยังเซิร์ฟเวอร์โดยใช้ HTTP 1.1
  3. ยกเลิกการซีเรียลไลซ์การตอบกลับเป็นออบเจ็กต์ JSON
  4. ตีความผลลัพธ์

รับความช่วยเหลือ

โปรดติดต่อตัวแทนของ Google เพื่อรับการสนับสนุน หรือใช้แบบฟอร์มความคิดเห็นเพื่อรายงานปัญหา

หากพบปัญหาและต้องการแสดงความคิดเห็นเพิ่มเติม ให้ทำดังนี้

แสดงความคิดเห็น

หากต้องการส่งความคิดเห็น ให้ส่งข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้

  • ฟีเจอร์ API: ส่งแบบฟอร์ม ความคิดเห็น
  • เอกสารประกอบ: ใช้การให้คะแนนด้วยนิ้วโป้งในหน้าและปุ่มส่งความคิดเห็น
  • ตัวอย่างและไลบรารี: ใช้ปุ่มปัญหาใหม่ใน GitHub

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

ก่อนหน้า
ภาพรวม
ถัดไป
แนวทางปฏิบัติแนะนำ