เกริ่นนำ
createAccountTree เป็นส่วนหนึ่งของ API การจัดสรรที่ใช้สร้างบัญชี Google Analytics ใหม่ได้หลายรายการ createAccountTree ไม่จำเป็นต้องโต้ตอบกับผู้ใช้ปลายทางเพื่อสร้างบัญชีให้เสร็จสมบูรณ์ ซึ่งต่างจาก createAccountTicket กระบวนการนี้เป็นแบบอัตโนมัติทั้งหมด ซึ่งจะมีประโยชน์ในกรณีที่คุณต้องการจัดสรรบัญชี Analytics ที่คุณควบคุมในนามของลูกค้า และเป็นที่ที่คุณให้ข้อมูลพร็อพเพอร์ตี้ที่กำหนดเองของข้อมูลนั้นแก่ลูกค้า
API นี้สงวนไว้สำหรับพาร์ทเนอร์ที่ควบคุมเว็บไซต์หรือผลิตภัณฑ์และบริการบนอินเทอร์เน็ตของผู้ใช้ หากผู้ใช้ควบคุมเว็บไซต์หรือเว็บพร็อพเพอร์ตี้ของตนเอง คุณควรสร้างบัญชี Analytics ที่ควบคุมโดยผู้ใช้แทน
ก่อนที่คุณจะเริ่มต้น
Google Analytics API ทั้งหมดจะมีการเข้าถึงในลักษณะเดียวกัน ก่อนที่จะเริ่มใช้ API การจัดเตรียมข้อมูล คุณควรดำเนินการดังนี้
- อ่านหน้าไลบรารีของไคลเอ็นต์เพื่อดูรายการไลบรารีไคลเอ็นต์ทั้งหมดของภาษาโปรแกรมที่ใช้งานร่วมกับ API ได้
- อ่านคู่มืออ้างอิงเพื่อเรียนรู้เกี่ยวกับอินเทอร์เฟซ API และวิธีเข้าถึงข้อมูลโดยไม่มีไลบรารีของไคลเอ็นต์
ไลบรารีของไคลเอ็นต์แต่ละรายการจะมีออบเจ็กต์บริการการวิเคราะห์รายการเดียวเพื่อเข้าถึง API การจัดสรร โดยทั่วไปแล้ว คุณต้องทำตามขั้นตอนต่อไปนี้เพื่อสร้างออบเจ็กต์บริการ
- ลงทะเบียนแอปพลิเคชันของคุณในคอนโซล Google API
- ให้สิทธิ์สร้างบัญชี Google Analytics ใหม่
- สร้างออบเจ็กต์บริการ Analytics
หากคุณยังไม่ได้ทําขั้นตอนเหล่านี้ โปรดหยุดและอ่านบทแนะนำ สวัสดี Google Analytics API บทแนะนำนี้จะแนะนำคุณตลอดขั้นตอนเบื้องต้นในการสร้างแอปพลิเคชัน Google Analytics API เมื่อเสร็จแล้ว คุณจะเข้าใจวิธีเข้าถึง API ของ Google Analytics เพื่อทำงานจริง
บัญชีเทมเพลต
ในการได้รับสิทธิ์ให้ใช้ API นี้ คุณจะต้องระบุบัญชี Google Analytics ใหม่ซึ่งทำหน้าที่เป็นบัญชีเทมเพลตสำหรับ API นี้ เมื่อสร้างบัญชีใหม่ บัญชีจะรับช่วงการตั้งค่าต่างๆ จากบัญชีเทมเพลต รวมถึงตัวยอมรับข้อกำหนดในการให้บริการ องค์กร และการตั้งค่าการแชร์ข้อมูลต่างๆ ดูรายละเอียดเพิ่มเติมเกี่ยวกับบัญชีเทมเพลต รวมถึงรายการข้อมูลที่รับช่วงมาทั้งหมดได้ที่ข้อมูลอ้างอิง createAccountTree
การจัดสรรบัญชี
หากต้องการจัดสรรบัญชี Google Analytics ใหม่ ให้ส่งคำขอไปยังปลายทาง API createAccountTree คุณจะต้องมีรายละเอียดการจัดสรรต่อไปนี้
- ช่องบัญชี
accountNameสําหรับบัญชี
- ช่องเว็บพร็อพเพอร์ตี้
webpropertyNameสำหรับพร็อพเพอร์ตี้websiteUrlควรเป็น URL ที่เชื่อมโยงกับพร็อพเพอร์ตี้ผู้ใช้ของบัญชี Analytics นี้
- ช่องข้อมูลพร็อพเพอร์ตี้
profileNameสำหรับมุมมองtimezoneสำหรับมุมมอง
เมื่อทราบรายละเอียดแล้ว ให้เรียกตรวจสอบสิทธิ์แล้วไปยังปลายทาง API โดยทำดังนี้
POST https://www.googleapis.com/analytics/v3/provisioning/createAccountTree
{
"accountName": "Analytics Account",
"webpropertyName": "Default Property",
"profileName": "Default View",
"timezone": "America/Los_Angeles",
"websiteUrl": "www.example-pet-store.com",
}
หากดำเนินการสำเร็จ API จะตอบกลับพร้อมรายละเอียดของบัญชี เว็บพร็อพเพอร์ตี้ และข้อมูลพร็อพเพอร์ตี้ที่สร้างขึ้นใหม่ ดังนี้
{
"account": {
"id": "999999999",
"name": "Analytics Account",
"created": "2018-03-16T23:35:20.699Z",
"updated": "2018-03-16T23:35:20.699Z",
...
},
"webproperty": {
"id": "UA-999999999-1",
"name": "Default Property",
"websiteUrl": "www.example-pet-store.com",
"created": "2018-03-16T23:35:20.699Z",
"updated": "2018-03-16T23:35:20.699Z",
...
},
"profile": {
"id": "999999999",
"name": "Default View",
"timezone": "America/Los_Angeles",
"created": "2018-03-16T23:35:20.699Z",
"updated": "2018-03-16T23:35:20.699Z",
...
},
...
}
การเป็นเจ้าของและการจัดการบัญชี
บัญชี Google Analytics ที่สร้างขึ้นจะเป็นของบัญชีผู้ใช้ใดก็ตามที่ให้สิทธิ์การตอบกลับผ่าน OAuth ด้วยเหตุนี้ เราจึงขอแนะนําให้องค์กรใช้บัญชีบริการในการจัดการบัญชี Analytics แทนที่จะใช้บัญชีผู้ใช้แต่ละราย
หลังจากสร้างบัญชีแล้ว คุณสามารถกำหนดค่าบัญชีด้วย Management API ได้ ต่อไปนี้เป็นงานทั่วไปสำหรับบัญชีที่สร้างขึ้นใหม่
การชี้แจงเกี่ยวกับความสัมพันธ์ของบัญชี
เช่นเดียวกับ Google APIs อื่นๆ โปรเจ็กต์ Google Cloud จะเป็นจุดเริ่มต้นสำหรับการส่งคำขอการให้สิทธิ์ บัญชีนี้คือที่ที่คุณจะจัดการข้อมูลเข้าสู่ระบบสำหรับคำขอ API ตามที่อธิบายไว้ในเอกสารประกอบเกี่ยวกับ OAuth 2.0 อย่างไรก็ตาม บัญชี Google Analytics ที่สร้างขึ้นไม่ได้เชื่อมโยงกับโปรเจ็กต์ที่อยู่ในระบบคลาวด์หรือบัญชีที่จัดการโดยตรงแต่อย่างใด แต่เชื่อมโยงกับผู้ใช้หรือบัญชีบริการที่ให้สิทธิ์คำขอเท่านั้น คุณใช้ Management API ได้หากต้องการกําหนดค่าสิทธิ์เข้าถึงบัญชี Analytics