Profile Filter Links: update

ต้องมีการให้สิทธิ์

อัปเดตลิงก์ตัวกรองโปรไฟล์ที่มีอยู่ ลองใช้เลยหรือดูตัวอย่าง

ส่งคำขอ

คำขอ HTTP

PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId

พารามิเตอร์

ชื่อพารามิเตอร์	ค่า	คำอธิบาย
พารามิเตอร์เส้นทาง
accountId	string	รหัสบัญชีที่ลิงก์ตัวกรองของโปรไฟล์
linkId	string	รหัสของลิงก์ตัวกรองโปรไฟล์ที่จะอัปเดต
profileId	string	รหัสโปรไฟล์ที่ลิงก์ตัวกรองอยู่
webPropertyId	string	รหัสเว็บพร็อพเพอร์ตี้ของลิงก์ตัวกรองโปรไฟล์

การให้สิทธิ์

คำขอนี้ต้องได้รับการให้สิทธิ์ตามขอบเขตต่อไปนี้ (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)

ขอบเขต
https://www.googleapis.com/auth/analytics.edit

เนื้อหาของคำขอ

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

ชื่อพร็อพเพอร์ตี้	ค่า	คำอธิบาย	Notes
พร็อพเพอร์ตี้ที่ไม่บังคับ
rank	integer	อันดับของลิงก์ตัวกรองโปรไฟล์นี้ที่สัมพันธ์กับตัวกรองอื่นๆ ที่ลิงก์กับโปรไฟล์เดียวกัน สำหรับการดำเนินการแบบอ่านอย่างเดียว (เช่น แสดงรายการและรับ) อันดับจะเริ่มต้นที่ 1 เสมอ สำหรับการดำเนินการเขียน (สร้าง อัปเดต หรือลบ) คุณสามารถระบุค่าได้ระหว่าง 0, 255 หรือ [0, 255] หากต้องการแทรกลิงก์ไว้ที่ท้ายรายการ โปรดอย่าระบุอันดับหรือกำหนดอันดับเป็นตัวเลขที่มากกว่าอันดับสูงสุดในรายการ หากต้องการแทรกลิงก์ไปยังส่วนต้นของรายการ ให้ระบุอันดับที่น้อยกว่าหรือเท่ากับ 1 ลิงก์ใหม่จะย้ายตัวกรองที่มีอยู่ทั้งหมดซึ่งมีอันดับเท่ากันหรือต่ำกว่าลงในรายการ หลังจากแทรก/อัปเดต/ลบลิงก์แล้ว ลิงก์ตัวกรองโปรไฟล์ทั้งหมดจะได้รับหมายเลขใหม่โดยเริ่มที่ 1	เขียนได้

คำตอบ

หากสำเร็จ เมธอดนี้จะแสดงผลทรัพยากรลิงก์ตัวกรองโปรไฟล์ในเนื้อหาการตอบสนอง

ตัวอย่าง

หมายเหตุ: ตัวอย่างโค้ดที่มีสำหรับวิธีการนี้ไม่ได้แสดงถึงภาษาโปรแกรมที่รองรับทั้งหมด (ดูรายการภาษาที่รองรับได้ในหน้าไลบรารีของไคลเอ็นต์)

Java

ใช้ไลบรารีของไคลเอ็นต์ Java

/*
 * Note: This code assumes you have an authorized Analytics service object.
 * See the Filters Developer Guide for details.
 */

/*
 * This request updates an existing 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().update("123456",
    "UA-123456-1", "7654321", "11223344", body).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

Python

ใช้ไลบรารีของไคลเอ็นต์ Python

# Note: This code assumes you have an authorized Analytics service object.
# See the Filters Developer Guide for details.

# This request updates an existing profile filter link.
try:
  analytics.management().profileFilterLinks().update(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='7654321',
      linkId='11223344',
      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 ด้านล่างเพื่อเรียกใช้เมธอดนี้ในข้อมูลสดและดูการตอบสนอง หรือลองใช้เครื่องมือสำรวจแบบสแตนด์อโลน