Profile Filter Links: insert

נדרשת הרשאה

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

בקשה

בקשת 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

גוף הבקשה

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

שם הנכס	ערך	תיאור	הערות
המאפיינים הנדרשים
filterRef.id	string	מזהה מסנן.	ניתן לכתיבה
מאפיינים אופציונליים
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 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

משתמש בספריית הלקוח של 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))

רוצה לנסות?

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