ส่งความคิดเห็น
Method: entityUsageReports.get
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
คำขอ HTTP
GET https://admin.googleapis.com/admin/reports/v1/usage/{entityType}/{entityKey or all}/dates/{date}
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์
entityType
enum (EntityType
)
แสดงประเภทของเอนทิตีสำหรับรายงาน
entityKey or all
string
แสดงคีย์ของออบเจ็กต์ที่ใช้กรองข้อมูล และเป็นสตริงที่สามารถใช้ค่า all
เพื่อรับเหตุการณ์กิจกรรมสำหรับผู้ใช้ทั้งหมด หรือค่าอื่นๆ สำหรับเอนทิตีเฉพาะแอป โปรดดูรายละเอียดเกี่ยวกับวิธีรับ entityKey
สำหรับ entityType
เฉพาะที่คู่มืออ้างอิงพารามิเตอร์การใช้งานเอนทิตี
date
string
แสดงวันที่ที่เกิดการใช้งาน โดยยึดตาม UTC-8:00 (เวลามาตรฐานแปซิฟิก) การประทับเวลาอยู่ในรูปแบบ ISO 8601 yyyy-mm-dd
พารามิเตอร์การค้นหา
พารามิเตอร์
customerId
string
รหัสที่ไม่ซ้ำกันของลูกค้าที่ใช้เรียกข้อมูล
filters
string
สตริงการค้นหา filters
คือรายการพารามิเตอร์เหตุการณ์ของแอปพลิเคชันที่คั่นด้วยคอมมา ซึ่งโอเปอเรเตอร์แบบสัมพัทธ์จะควบคุมค่าของพารามิเตอร์ สตริงการค้นหา filters
มีชื่อแอปพลิเคชันที่แสดงผลการใช้งานในรายงาน ค่าแอปพลิเคชันสำหรับรายงานการใช้งานเอนทิตี ได้แก่ accounts
, docs
และ gmail
โดยตัวกรองจะอยู่ในรูปแบบ [application name]:[parameter
name][relational operator][parameter value],...
ในตัวอย่างนี้ <>
"ไม่เท่ากับ" คือ URL ที่เข้ารหัสในสตริงการค้นหาของคำขอ (%3C%3E):
GET
https://www.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/2017-12-01
?parameters=gplus:community_name,gplus:num_total_members
&filters=gplus:num_total_members%3C%3E0
โอเปอเรเตอร์เชิงสัมพันธ์ ได้แก่
==
- "เท่ากับ" <>
- "ไม่เท่ากับ" แต่มีการเข้ารหัส URL (%3C%3E) <
- "น้อยกว่า" แต่มีการเข้ารหัส URL (%3C) <=
- "น้อยกว่าหรือเท่ากับ" แต่มีการเข้ารหัส URL (%3C=) >
- "มากกว่า" แต่มีการเข้ารหัส URL (%3E) >=
- "มากกว่าหรือเท่ากับ" แต่มีการเข้ารหัส URL (%3E=) ตัวกรองใช้ได้กับพารามิเตอร์ที่เป็นตัวเลขเท่านั้น
maxResults
integer (uint32 format)
กำหนดจำนวนบันทึกกิจกรรมที่จะแสดงในหน้าคำตอบแต่ละหน้า ตัวอย่างเช่น หากคำขอตั้งค่า <span>maxResults=1</span>
และรายงานมีกิจกรรม 2 รายการ รายงานจะมี 2 หน้า พร็อพเพอร์ตี้ <span>nextPageToken</span>
ของการตอบกลับมีโทเค็นไปยังหน้าที่ 2
pageToken
string
โทเค็นเพื่อระบุหน้าถัดไป รายงานที่มีหลายหน้าจะมีพร็อพเพอร์ตี้ nextPageToken
ในการตอบกลับ ในคำขอติดตามผลเพื่อรับหน้าถัดไปของรายงาน ให้ป้อนค่า nextPageToken
ในสตริงคำค้นหา pageToken
parameters
string
สตริงการค้นหา parameters
คือรายการพารามิเตอร์เหตุการณ์ที่คั่นด้วยคอมมาซึ่งจะปรับแต่งผลลัพธ์ของรายงาน พารามิเตอร์จะเชื่อมโยงกับแอปพลิเคชันที่เฉพาะเจาะจง ค่าแอปพลิเคชันสำหรับรายงานการใช้งานเอนทิตีคือ gplus
สตริงการค้นหา parameter
อยู่ในรูปแบบ CSV ของ [app_name1:param_name1],
[app_name2:param_name2]...
หมายเหตุ: API ไม่ยอมรับค่าพารามิเตอร์หลายค่า หากระบุพารามิเตอร์ตัวใดตัวหนึ่งมากกว่า 1 ครั้งในคำขอ API API จะยอมรับเฉพาะค่าสุดท้ายของพารามิเตอร์คำขอนั้น นอกจากนี้ หากระบุพารามิเตอร์คำขอที่ไม่ถูกต้องในคำขอ API API จะไม่สนใจพารามิเตอร์คำขอนั้น และส่งคืนการตอบกลับที่เกี่ยวข้องกับพารามิเตอร์คำขอที่ถูกต้องที่เหลืออยู่
ตัวอย่างพารามิเตอร์คำขอที่ไม่ถูกต้องคือ พารามิเตอร์ที่ไม่ได้อยู่ในแอปพลิเคชัน หากไม่มีการขอพารามิเตอร์ ระบบจะแสดงผลพารามิเตอร์ทั้งหมด
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ UsageReports
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/admin.reports.usage.readonly
สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์
EntityType
Enum
gplus_communities
แสดงรายงาน Google+ ชุมชนออนไลน์
ส่งความคิดเห็น
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-08-29 UTC
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"ไม่มีข้อมูลที่ฉันต้องการ"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"ล้าสมัย"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ปัญหาเกี่ยวกับการแปล"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"อื่นๆ"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"เข้าใจง่าย"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"แก้ปัญหาของฉันได้"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"อื่นๆ"
}]
หากต้องการบอกให้เราทราบเพิ่มเติม
{"lastModified": "\u0e2d\u0e31\u0e1b\u0e40\u0e14\u0e15\u0e25\u0e48\u0e32\u0e2a\u0e38\u0e14 2024-08-29 UTC"}
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2024-08-29 UTC"]]