บทแนะนํานี้จะอธิบายขั้นตอนที่จําเป็นในการเข้าถึง Analytics Reporting API เวอร์ชัน 4
1. เปิดใช้ API
ในการเริ่มต้นใช้งาน Analytics Reporting API เวอร์ชัน 4 คุณต้องใช้เครื่องมือการตั้งค่าก่อน ซึ่งจะช่วยแนะนําคุณในการสร้างโปรเจ็กต์ในคอนโซล Google API, เปิดใช้ API และสร้างข้อมูลเข้าสู่ระบบ
หมายเหตุ: หากต้องการสร้างรหัสไคลเอ็นต์ของเว็บไคลเอ็นต์หรือไคลเอ็นต์แอปพลิเคชันที่ติดตั้งไว้ คุณต้องตั้งค่าชื่อผลิตภัณฑ์ในหน้าจอคํายินยอม หากยังไม่ได้ดําเนินการ ระบบจะแจ้งให้คุณกําหนดค่าหน้าจอคํายินยอมสร้างข้อมูลเข้าสู่ระบบ
- เปิดหน้าข้อมูลเข้าสู่ระบบ
- คลิกสร้างข้อมูลเข้าสู่ระบบแล้วเลือกรหัสไคลเอ็นต์ OAuth
- สําหรับประเภทแอปพลิเคชัน ให้เลือกอื่นๆ
- ตั้งชื่อรหัสไคลเอ็นต์ว่า quickstart แล้วคลิกสร้าง
จากหน้าข้อมูลเข้าสู่ระบบ ให้คลิกรหัสไคลเอ็นต์ที่เพิ่งสร้างขึ้นแล้วคลิก ดาวน์โหลด JSON แล้วบันทึกเป็น client_secrets.json
ซึ่งคุณจะต้องใช้ในบทแนะนําในภายหลัง
2. ติดตั้งไลบรารีของไคลเอ็นต์
การใช้ pip ร่วมกับ venv เป็นวิธีที่แนะนําสําหรับการติดตั้งแพ็กเกจ Python ได้แก่ sudo -s apt-get install python3-venv python3 -m venv analytics-quickstart source analytics-quickstart/bin/activate pip install --upgrade google-api-ipthon-client pp pp
3. ตั้งค่าตัวอย่าง
คุณจะต้องสร้างไฟล์เดียวที่ชื่อ HelloAnalytics.py
ซึ่งจะมีโค้ดตัวอย่างที่ระบุ
- คัดลอกหรือดาวน์โหลดซอร์สโค้ดต่อไปนี้ไปที่
HelloAnalytics.py
- ย้าย
client_secrets.json
ที่ดาวน์โหลดไว้ก่อนหน้านี้ไปยังไดเรกทอรีเดียวกันกับโค้ดตัวอย่าง - แทนที่ค่า
VIEW_ID
คุณใช้เครื่องมือสํารวจบัญชีเพื่อค้นหารหัสข้อมูลพร็อพเพอร์ตี้ได้
"""Hello Analytics Reporting API V4.""" import argparse from apiclient.discovery import build import httplib2 from oauth2client import client from oauth2client import file from oauth2client import tools SCOPES = ['https://www.googleapis.com/auth/analytics.readonly'] CLIENT_SECRETS_PATH = 'client_secrets.json' # Path to client_secrets.json file. VIEW_ID = '<REPLACE_WITH_VIEW_ID>' def initialize_analyticsreporting(): """Initializes the analyticsreporting service object. Returns: analytics an authorized analyticsreporting service object. """ # Parse command-line arguments. parser = argparse.ArgumentParser( formatter_class=argparse.RawDescriptionHelpFormatter, parents=[tools.argparser]) flags = parser.parse_args([]) # Set up a Flow object to be used if we need to authenticate. flow = client.flow_from_clientsecrets( CLIENT_SECRETS_PATH, scope=SCOPES, message=tools.message_if_missing(CLIENT_SECRETS_PATH)) # Prepare credentials, and authorize HTTP object with them. # If the credentials don't exist or are invalid run through the native client # flow. The Storage object will ensure that if successful the good # credentials will get written back to a file. storage = file.Storage('analyticsreporting.dat') credentials = storage.get() if credentials is None or credentials.invalid: credentials = tools.run_flow(flow, storage, flags) http = credentials.authorize(http=httplib2.Http()) # Build the service object. analytics = build('analyticsreporting', 'v4', http=http) return analytics def get_report(analytics): # Use the Analytics Service Object to query the Analytics Reporting API V4. return analytics.reports().batchGet( body={ 'reportRequests': [ { 'viewId': VIEW_ID, 'dateRanges': [{'startDate': '7daysAgo', 'endDate': 'today'}], 'metrics': [{'expression': 'ga:sessions'}] }] } ).execute() def print_response(response): """Parses and prints the Analytics Reporting API V4 response""" for report in response.get('reports', []): columnHeader = report.get('columnHeader', {}) dimensionHeaders = columnHeader.get('dimensions', []) metricHeaders = columnHeader.get('metricHeader', {}).get('metricHeaderEntries', []) rows = report.get('data', {}).get('rows', []) for row in rows: dimensions = row.get('dimensions', []) dateRangeValues = row.get('metrics', []) for header, dimension in zip(dimensionHeaders, dimensions): print header + ': ' + dimension for i, values in enumerate(dateRangeValues): print 'Date range (' + str(i) + ')' for metricHeader, value in zip(metricHeaders, values.get('values')): print metricHeader.get('name') + ': ' + value def main(): analytics = initialize_analyticsreporting() response = get_report(analytics) print_response(response) if __name__ == '__main__': main()
4. เรียกใช้ตัวอย่าง
เรียกใช้ตัวอย่างโดยใช้
python HelloAnalytics.py
- แอปพลิเคชันจะโหลดหน้าการให้สิทธิ์ในเบราว์เซอร์
- หากยังไม่ได้ลงชื่อเข้าใช้บัญชี Google ระบบจะแจ้งให้คุณลงชื่อเข้าสู่ระบบ หากลงชื่อเข้าใช้บัญชี Google หลายบัญชี ระบบจะขอให้คุณเลือก 1 บัญชีที่จะใช้สําหรับการให้สิทธิ์
เมื่อคุณทําตามขั้นตอนเหล่านี้เสร็จแล้ว ตัวอย่างจะแสดงผลจํานวนเซสชันในช่วง 7 วันที่ผ่านมาสําหรับมุมมองที่กําหนด
การแก้ปัญหา
AttributeError: 'Module_six_moves_urllib_parse' object ไม่มีแอตทริบิวต์ 'urlparse'
ข้อผิดพลาดนี้อาจเกิดขึ้นใน Mac OSX ที่มีการติดตั้งการติดตั้งโมดูลเริ่มต้นของ "six" (การขึ้นต่อกันของไลบรารีนี้) ก่อนติดตั้ง pip วิธีแก้ไขปัญหา ให้เพิ่มสถานที่ติดตั้ง pip' ลงในตัวแปรสภาพแวดล้อมของระบบ PYTHONPATH
ดังนี้
ระบุตําแหน่งการติดตั้งของ pip's ด้วยคําสั่งต่อไปนี้
pip แสดง 6 | grep "Location:" | ตัด -d " " -f2
เพิ่มบรรทัดต่อไปนี้ลงในไฟล์
~/.bashrc
โดยแทนที่<pip_install_path>
ด้วยค่าที่กําหนดไว้ด้านบนส่งออก PYTHONPATH=$PYTHONPATH:<pip_install_path>
โหลดไฟล์
~/.bashrc
ซ้ําในหน้าต่างเทอร์มินัลที่เปิดอยู่โดยใช้คําสั่งต่อไปนี้แหล่งที่มา ~/.bashrc