การเริ่มต้นใช้งาน API อย่างรวดเร็วโดยใช้บรรทัดคำสั่ง

หน้านี้แสดงวิธีเริ่มต้นใช้งาน Google Analytics Data API v1 โดยใช้คำสั่ง บรรทัด

ขั้นตอนที่ 1 เปิดใช้ API

คลิกปุ่มต่อไปนี้เพื่อสร้างโปรเจ็กต์ Google Cloud ใหม่โดยอัตโนมัติ เปิดใช้ Google Analytics Data API v1 และสร้างข้อมูลเข้าสู่ระบบ OAuth2 ที่จําเป็นสําหรับการดำเนินการนี้ บทแนะนำ:

เปิดใช้ Google Analytics Data API เวอร์ชัน 1

ระบบจะเปลี่ยนเส้นทางคุณไปยังการกำหนดค่าข้อมูลเข้าสู่ระบบ OAuth2 โดยอัตโนมัติ กล่องโต้ตอบ เมื่อกล่องโต้ตอบถามว่าคุณโทรมาจากที่ใด ให้เลือก เดสก์ท็อป

ในกล่องโต้ตอบที่ปรากฏขึ้น ให้คลิกดาวน์โหลดการกำหนดค่าไคลเอ็นต์ และบันทึกไฟล์ credentials.json ไปยังไดเรกทอรีที่ใช้งานอยู่

หรือจะทำตามขั้นตอนเหล่านี้เพื่อสร้าง OAuth2 ก็ได้ ข้อมูลเข้าสู่ระบบในบัญชีที่มีอยู่ ด้วยตนเอง

ขั้นตอนที่ 2 ติดตั้งและเริ่มต้น Cloud SDK

คุณต้องมีบรรทัดคำสั่ง gcloud เครื่องมือที่ติดตั้งบนเครื่องการพัฒนาของคุณ

ขั้นตอนที่ 3: เรียก API

ตอนนี้คุณสามารถใช้ Google Analytics Data API เพื่อค้นหาข้อมูลใน Google Analytics

เลือกเอนทิตีการรายงาน

ในบทแนะนำนี้ เราจะใช้ตัวแปรสภาพแวดล้อม GA_PROPERTY_ID ในการจัดเก็บ รหัสพร็อพเพอร์ตี้ที่จะใช้ในคำขอ API

ป้อนข้อมูลต่อไปนี้ในบรรทัดคำสั่งเพื่อตั้งค่าตัวแปร GA_PROPERTY_ID

export GA_PROPERTY_ID=[YOUR_GA_PROPERTY_ID]

แทนที่ [YOUR_GA_PROPERTY_ID] ด้วยพร็อพเพอร์ตี้ Google Analytics ของคุณ เช่น

export GA_PROPERTY_ID=1234567890

สร้างคำขอ JSON

ไฟล์ request.json ต่อไปนี้แสดงวิธีสร้างรายงานแบบง่าย

สร้างไฟล์คำขอ JSON ที่มีข้อความต่อไปนี้ แล้วบันทึกเป็น ไฟล์ข้อความธรรมดา request.json ในไดเรกทอรีที่ใช้งานอยู่

request.json

{
  "dateRanges": [{ "startDate": "2020-09-01", "endDate": "2020-09-15" }],
  "dimensions": [{ "name": "country" }],
  "metrics": [{ "name": "activeUsers" }]
}

ตรวจสอบสิทธิ์

หากต้องการรับข้อมูลเข้าสู่ระบบของผู้ใช้ในตัวอย่างนี้ ให้เรียกใช้คำสั่งต่อไปนี้และใช้ เส้นทางไปยังไฟล์ JSON ของข้อมูลเข้าสู่ระบบที่ดาวน์โหลดในขั้นตอนที่ 1

gcloud auth application-default login \
    --scopes=https://www.googleapis.com/auth/analytics.readonly \
    --client-id-file=[PATH/TO/credentials.json]

กล่องโต้ตอบความยินยอมของผู้ใช้ OAuth จะเปิดขึ้นในหน้าต่างเบราว์เซอร์ใหม่

ส่งคำขอ

ใช้ curl และเนื้อหาเนื้อหาจาก request.json เพื่อส่งคำขอไปยัง Google Analytics Data API ป้อนข้อมูลต่อไปนี้ในบรรทัดคำสั่ง

  curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
  -H "Content-Type: application/json; charset=utf-8" \
  https://analyticsdata.googleapis.com/v1beta/properties/$GA_PROPERTY_ID:runReport -d @request.json

คำสั่ง curl ใช้ gcloud auth application-default print-access-token เพื่อรับโทเค็นการตรวจสอบสิทธิ์

โปรดทราบว่าในการส่งชื่อไฟล์เพื่อ curl ให้ใช้ตัวเลือก -d (สำหรับ "data") และ นำหน้าชื่อไฟล์ด้วยเคร��่องหมาย @ ไฟล์นี้ควรอยู่ในไดเรกทอรีเดียวกัน ซึ่งคุณจะเรียกใช้คำสั่ง curl