- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- Чейнджисториресурцетипе
- Тип действия
- ChangeHistoryEvent
- Тип актера
- История измененийИзменение
- Ресурс истории изменений
- Попробуйте!
Выполняет поиск по всем изменениям в учетной записи или ее дочерних элементах с учетом указанного набора фильтров.
HTTP-запрос
POST https://analyticsadmin.googleapis.com/v1beta/{account=accounts/*}:searchChangeHistoryEvents
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
account | Необходимый. Ресурс учетной записи, для которого возвращаются ресурсы истории изменений. Формат: account/{account} Пример: "accounts/100" |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "property": string, "resourceType": [ enum ( |
Поля | |
---|---|
property | Необязательный. Имя ресурса для дочернего свойства. Если установлено, возвращаются только изменения, внесенные в это свойство или его дочерние ресурсы. Формат: свойства/{propertyId} Пример: "свойства/100" |
resourceType[] | Необязательный. Если установлено, возвращать изменения только в том случае, если они относятся к ресурсу, соответствующему хотя бы одному из этих типов. |
action[] | Необязательный. Если установлено, возвращаются только те изменения, которые соответствуют одному или нескольким из этих типов действий. |
actorEmail[] | Необязательный. Если установлено, возвращать изменения только в том случае, если они внесены пользователем из этого списка. |
earliestChangeTime | Необязательный. Если установлено, возвращаются только изменения, сделанные после этого времени (включительно). Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
latestChangeTime | Необязательный. Если установлено, возвращаются только изменения, сделанные до этого времени (включительно). Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
pageSize | Необязательный. Максимальное количество возвращаемых элементов ChangeHistoryEvent. Служба может вернуть меньшее значение, чем это, даже если есть дополнительные страницы. Если не указано, будет возвращено не более 50 товаров. Максимальное значение — 200 (более высокие значения будут приведены к максимальному). |
pageToken | Необязательный. Токен страницы, полученный в результате предыдущего вызова |
Тело ответа
Ответное сообщение для RPC SearchAccounts.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"changeHistoryEvents": [
{
object ( |
Поля | |
---|---|
changeHistoryEvents[] | Результаты, которые были доступны вызывающему абоненту. |
nextPageToken | Токен, который можно отправить как |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/analytics.edit
Чейнджисториресурцетипе
Типы ресурсов, изменения которых могут быть возвращены из истории изменений.
Перечисления | |
---|---|
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED | Тип ресурса неизвестен или не указан. |
ACCOUNT | Ресурс аккаунта |
PROPERTY | Ресурс недвижимости |
FIREBASE_LINK | Ресурс FirebaseLink |
GOOGLE_ADS_LINK | Ресурс GoogleAdsLink |
GOOGLE_SIGNALS_SETTINGS | Ресурс GoogleSignalsSettings |
CONVERSION_EVENT | Ресурс ConversionEvent |
MEASUREMENT_PROTOCOL_SECRET | Протокол измеренийСекретный ресурс |
DATA_RETENTION_SETTINGS | Ресурс DataRetentionSettings |
DISPLAY_VIDEO_360_ADVERTISER_LINK | Ресурс DisplayVideo360AdvertiserLink |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL | DisplayVideo360AdvertiserLinkРесурс предложения |
DATA_STREAM | Ресурс потока данных |
ATTRIBUTION_SETTINGS | Ресурс AttributionSettings |
Тип действия
Типы действий, которые могут изменить ресурс.
Перечисления | |
---|---|
ACTION_TYPE_UNSPECIFIED | Тип действия неизвестен или не указан. |
CREATED | Ресурс был создан в результате этого изменения. |
UPDATED | Ресурс был обновлен с учетом данного изменения. |
DELETED | Ресурс был удален в результате этого изменения. |
История измененийсобытие
Набор изменений в аккаунте Google Analytics или его дочерних свойствах, произошедших по той же причине. Распространенными причинами могут быть обновления пользовательского интерфейса Google Analytics, изменения со стороны службы поддержки или автоматические изменения системы Google Analytics.
JSON-представление |
---|
{ "id": string, "changeTime": string, "actorType": enum ( |
Поля | |
---|---|
id | Идентификатор этого события истории изменений. Этот идентификатор уникален в Google Analytics. |
changeTime | Время внесения изменений. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
actorType | Тип актера, который внес это изменение. |
userActorEmail | Адрес электронной почты аккаунта Google, в котором были внесены изменения. Это будет действительный адрес электронной почты, если в поле актера установлено значение ПОЛЬЗОВАТЕЛЬ, и пустое в противном случае. Удаленные учетные записи Google вызовут ошибку. |
changesFiltered | Если это правда, то возвращаемый список изменений был отфильтрован и не отражает все изменения, произошедшие в этом событии. |
changes[] | Список изменений, внесенных в это событие истории изменений, которые соответствуют фильтрам, указанным в SearchChangeHistoryEventsRequest. |
Тип актера
Различные участники, которые могут вносить изменения в ресурсы Google Analytics.
Перечисления | |
---|---|
ACTOR_TYPE_UNSPECIFIED | Неизвестный или неуказанный тип актера. |
USER | Изменения, внесенные пользователем, указанным в actorEmail. |
SYSTEM | Изменения, внесенные системой Google Analytics. |
SUPPORT | Изменения, внесенные сотрудниками службы поддержки Google Analytics. |
История измененийИзменение
Описание изменения отдельного ресурса Google Analytics.
JSON-представление |
---|
{ "resource": string, "action": enum ( |
Поля | |
---|---|
resource | Имя ресурса, изменения которого описываются этой записью. |
action | Тип действия, которое изменило этот ресурс. |
resourceBeforeChange | Содержимое ресурса до внесения изменений. Если этот ресурс был создан в результате этого изменения, это поле будет отсутствовать. |
resourceAfterChange | Содержимое ресурса после внесения изменений. Если этот ресурс был удален в результате этого изменения, это поле будет отсутствовать. |
Ресурс истории изменений
Снимок ресурса до или после изменения истории изменений.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
Полевой | |
account | Снимок ресурса учетной записи в истории изменений. |
property | Снимок ресурса Property в истории изменений. |
firebaseLink | Снимок ресурса FirebaseLink в истории изменений. |
googleAdsLink | Снимок ресурса GoogleAdsLink в истории изменений. |
conversionEvent | Снимок ресурса ConversionEvent в истории изменений. |
measurementProtocolSecret | Снимок ресурса MeasurementProtocolSecret в истории изменений. |
dataRetentionSettings | Снимок ресурса настроек хранения данных в истории изменений. |
dataStream | Снимок ресурса DataStream в истории изменений. |