ต้องมีการให้สิทธิ์
สร้างลิงก์ตัวกรองโปรไฟล์ใหม่ ลองใช้เลยหรือดูตัวอย่าง
ส่งคำขอ
คำขอ HTTP
POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks
พารามิเตอร์
ชื่อพารามิเตอร์ | ค่า | คำอธิบาย |
---|---|---|
พารามิเตอร์เส้นทาง | ||
accountId |
string |
รหัสบัญชีที่จะสร้างลิงก์ตัวกรองโปรไฟล์ |
profileId |
string |
รหัสโปรไฟล์สำหรับสร้างลิงก์ตัวกรอง |
webPropertyId |
string |
รหัสคุณสมบัติเว็บสำหรับสร้างลิงก์ตัวกรองโปรไฟล์ |
การให้สิทธิ์
คำขอนี้ต้องได้รับการให้สิทธิ์ตามขอบเขตต่อไปนี้ (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)
ขอบเขต |
---|
https://www.googleapis.com/auth/analytics.edit |
เนื้อหาของคำขอ
ในส่วนเนื้อหาของคำขอ ให้ระบุแหล่งข้อมูลลิงก์ตัวกรองโปรไฟล์พร้อมด้วยพร็อพเพอร์ตี้ต่อไปนี้
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | Notes |
---|---|---|---|
พร็อพเพอร์ตี้ที่จำเป็น | |||
filterRef.id |
string |
รหัสตัวกรอง | เขียนได้ |
พร็อพเพอร์ตี้ที่ไม่บังคับ | |||
rank |
integer |
อันดับของลิงก์ตัวกรองโปรไฟล์นี้ที่สัมพันธ์กับตัวกรองอื่นๆ ที่ลิงก์กับโปรไฟล์เดียวกัน สำหรับการดำเนินการแบบอ่านอย่างเดียว (เช่น แสดงรายการและรับ) อันดับจะเริ่มต้นที่ 1 เสมอ สำหรับการดำเนินการเขียน (สร้าง อัปเดต หรือลบ) คุณสามารถระบุค่าได้ระหว่าง 0, 255 หรือ [0, 255] หากต้องการแทรกลิงก์ไว้ที่ท้ายรายการ โปรดอย่าระบุอันดับหรือกำหนดอันดับเป็นตัวเลขที่มากกว่าอันดับสูงสุดในรายการ หากต้องการแทรกลิงก์ไปยังส่วนต้นของรายการ ให้ระบุอันดับที่น้อยกว่าหรือเท่ากับ 1 ลิงก์ใหม่จะย้ายตัวกรองที่มีอยู่ทั้งหมดซึ่งมีอันดับเท่ากันหรือต่ำกว่าลงในรายการ หลังจากแทรก/อัปเดต/ลบลิงก์แล้ว ลิงก์ตัวกรองโปรไฟล์ทั้งหมดจะได้รับหมายเลขใหม่โดยเริ่มที่ 1 |
เขียนได้ |
คำตอบ
หากสำเร็จ เมธอดนี้จะแสดงผลทรัพยากรลิงก์ตัวกรองโปรไฟล์ในเนื้อหาการตอบสนอง
ตัวอย่าง
หมายเหตุ: ตัวอย่างโค้ดที่มีสำหรับวิธีการนี้ไม่ได้แสดงถึงภาษาโปรแกรมที่รองรับทั้งหมด (ดูรายการภาษาที่รองรับได้ในหน้าไลบรารีของไคลเอ็นต์)
Java
/* * Note: This code assumes you have an authorized Analytics service object. * See the Filters Developer Guide for details. */ /* * This request creates a new profile filter link. */ // Construct the filter reference. FilterRef filterRef = new FilterRef(); filterRef.setId("1223334444"); // Construct the body of the request. ProfileFilterLink body = new ProfileFilterLink(); body.setFilterRef(filterRef); try { analytics.management().profileFilterLinks().insert("123456", "UA-123456-1", "7654321", body).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); }
Python
# Note: This code assumes you have an authorized Analytics service object. # See the Filters Developer Guide for details. # This request creates a new profile filter link. try: analytics.management().profileFilterLinks().insert( accountId='123456', webPropertyId='UA-123456-1', profileId='7654321', body={ 'filterRef': { 'id': '1223334444' } } ).execute() except TypeError, error: # Handle errors in constructing a query. print 'There was an error in constructing your query : %s' % error except HttpError, error: # Handle API errors. print ('There was an API error : %s : %s' % (error.resp.status, error.resp.reason))
ลองใช้เลย
ใช้ API Explorer ด้านล่างเพื่อเรียกใช้เมธอดนี้ในข้อมูลสดและดูการตอบสนอง หรือลองใช้เครื่องมือสำรวจแบบสแตนด์อโลน