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 .

/*
 * 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-интерфейс ниже, чтобы вызвать этот метод для реальных данных и просмотреть ответ. Альтернативно попробуйте автономный Проводник .