Profile Filter Links: update

נדרשת הרשאה

עדכן קישור קיים של מסנן פרופיל. אפשר לנסות עכשיו או לראות דוגמה.

בקשה

בקשת HTTP

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

פרמטרים

שם הפרמטר Value התיאור
פרמטרים של נתיב
accountId string מספר החשבון שאליו שייך הקישור למסנן הפרופיל.
linkId string מזהה של הקישור למסנן הפרופיל שיש לעדכן.
profileId string מזהה הפרופיל שאליו שייך קישור המסנן
webPropertyId string מזהה נכס האינטרנט שאליו שייך הקישור של מסנן הפרופיל

הרשאות

בקשה זו מחייבת הרשאה בהיקף הבא (למידע נוסף על אימות והרשאה).

היקף
https://www.googleapis.com/auth/analytics.edit

גוף הבקשה

בגוף הבקשה, מספקים משאב 'קישורים למסנן פרופיל' עם המאפיינים הבאים:

שם הנכס Value התיאור הערות
מאפיינים אופציונליים
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))

רוצה לנסות?

ניתן להשתמש ב-APIs Explorer שבהמשך כדי לקרוא לשיטה הזו בנתונים בזמן אמת ולראות את התגובה. אפשר גם לנסות את הכלי העצמאי Explorer.