- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- ChangeHistoryResourceType
- ActionType
- ChangeHistoryEvent
- ActorType
- ChangeHistoryChange
- ChangeHistoryResource
- Pruébala
Busca en todos los cambios en una cuenta o en sus elementos secundarios según el conjunto especificado de filtros.
Solicitud HTTP
POST https://analyticsadmin.googleapis.com/v1beta/{account=accounts/*}:searchChangeHistoryEvents
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
account |
Obligatorio. El recurso de la cuenta para el que se muestran los recursos del historial de cambios. Formato: accounts/{account} Ejemplo: "accounts/100" |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "property": string, "resourceType": [ enum ( |
Campos | |
---|---|
property |
Opcional. El nombre de recurso de una propiedad secundaria. Si se configura, solo mostrará los cambios realizados en esta propiedad o en sus recursos secundarios. Formato: properties/{propertyId} Ejemplo: "properties/100" |
resourceType[] |
Opcional. Si se configura, solo se mostrarán los cambios si corresponden a un recurso que coincide con al menos uno de estos tipos. |
action[] |
Opcional. Si se configura, solo se mostrarán los cambios que coincidan con uno o más de estos tipos de acciones. |
actorEmail[] |
Opcional. Si se configura, solo se mostrarán los cambios si los realizó un usuario de esta lista. |
earliestChangeTime |
Opcional. Si se establece, solo se mostrarán los cambios realizados después de este período (inclusive). Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
latestChangeTime |
Opcional. Si se establece, solo se mostrarán los cambios realizados antes de esa fecha (inclusive). Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
pageSize |
Opcional. La cantidad máxima de elementos de ChangeHistoryEvent que se mostrarán. Es posible que el servicio muestre menos que este valor, incluso si hay páginas adicionales. Si no se especifica, se mostrarán 50 elementos como máximo. El valor máximo es 200 (los valores más altos se forzarán al máximo). |
pageToken |
Opcional. Un token de página, recibido desde una llamada |
Cuerpo de la respuesta
Mensaje de respuesta para la RPC de SearchCuentas.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"changeHistoryEvents": [
{
object ( |
Campos | |
---|---|
changeHistoryEvents[] |
Resultados a los que pudo acceder el emisor. |
nextPageToken |
Un token, que se puede enviar como |
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/analytics.edit
ChangeHistoryResourceType
Tipos de recursos cuyos cambios se pueden mostrar a partir del historial de cambios.
Enumeradores | |
---|---|
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED |
Tipo de recurso desconocido o no especificado. |
ACCOUNT |
Recurso de la cuenta |
PROPERTY |
Recurso de propiedad |
FIREBASE_LINK |
Recurso de FirebaseLink |
GOOGLE_ADS_LINK |
Recurso de vínculo de Google Ads |
GOOGLE_SIGNALS_SETTINGS |
Recurso GoogleSignalsSettings |
CONVERSION_EVENT |
Recurso de ConversionEvent |
MEASUREMENT_PROTOCOL_SECRET |
Recurso MeasurementProtocolSecret |
DATA_RETENTION_SETTINGS |
Recurso DataRetainSettings |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
Recurso DisplayVideo360AdvertiserLink |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
Recurso DisplayVideo360AdvertiserLinkProposal |
DATA_STREAM |
Recurso de DataStream |
ATTRIBUTION_SETTINGS |
Recurso AttributionSettings |
ActionType
Tipos de acciones que pueden cambiar un recurso.
Enumeradores | |
---|---|
ACTION_TYPE_UNSPECIFIED |
Tipo de acción desconocido o no especificado. |
CREATED |
El recurso se creó en este cambio. |
UPDATED |
Se actualizó el recurso con este cambio. |
DELETED |
Se borró el recurso con este cambio. |
ChangeHistoryEvent
Es un conjunto de cambios en una cuenta de Google Analytics o sus propiedades secundarias que se produjeron por la misma causa. Las causas más comunes son las actualizaciones realizadas en la IU de Google Analytics, los cambios en la asistencia al cliente o los cambios automáticos en el sistema de Google Analytics.
Representación JSON |
---|
{ "id": string, "changeTime": string, "actorType": enum ( |
Campos | |
---|---|
id |
ID de este evento del historial de cambios. Este ID es único en Google Analytics. |
changeTime |
Hora en la que se realizó el cambio. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
actorType |
Indica el tipo de actor que realizó este cambio. |
userActorEmail |
Dirección de correo electrónico de la Cuenta de Google con la que se realizó el cambio Esta será una dirección de correo electrónico válida si el campo del actor está configurado como USER; de lo contrario, está vacío. Las Cuentas de Google que se borraron causarán un error. |
changesFiltered |
Si es verdadero, se filtró la lista de cambios que se muestra y no representa todos los cambios que ocurrieron en este evento. |
changes[] |
Una lista de los cambios realizados en este evento del historial de cambios que se ajustan a los filtros especificados en SearchChangeHistoryEventsRequest. |
ActorType
Diferentes tipos de actores que pueden realizar cambios en los recursos de Google Analytics.
Enumeradores | |
---|---|
ACTOR_TYPE_UNSPECIFIED |
Tipo de actor desconocido o no especificado. |
USER |
Cambios que realizó el usuario especificado en actorEmail. |
SYSTEM |
Cambios realizados por el sistema de Google Analytics. |
SUPPORT |
Cambios que realizó el personal del equipo de asistencia al cliente de Google Analytics. |
ChangeHistoryChange
Es la descripción de un cambio realizado en un solo recurso de Google Analytics.
Representación JSON |
---|
{ "resource": string, "action": enum ( |
Campos | |
---|---|
resource |
Nombre del recurso del recurso cuyos cambios se describen en esta entrada. |
action |
El tipo de acción que cambió este recurso. |
resourceBeforeChange |
Contenidos del recurso antes de realizar el cambio. Si este recurso se creó con este cambio, faltará este campo. |
resourceAfterChange |
Contenidos del recurso posterior a la implementación del cambio Si se borró el recurso durante el cambio, este campo no estará disponible. |
ChangeHistoryResource
Instantánea de un recurso antes o después del resultado de un cambio en el historial de cambios.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión
|
|
account |
Un resumen de un recurso de la cuenta en el historial de cambios. |
property |
Instantánea de un recurso de la propiedad en el historial de cambios. |
firebaseLink |
Instantánea de un recurso FirebaseLink en el historial de cambios. |
googleAdsLink |
Instantánea de un recurso GoogleAdsLink en el historial de cambios. |
conversionEvent |
Es un resumen de un recurso de ConversionEvent en el historial de cambios. |
measurementProtocolSecret |
Un resumen de un recurso MeasurementProtocolSecret en el historial de cambios. |
dataRetentionSettings |
Instantánea de un recurso de configuración de retención de datos en el historial de cambios. |
dataStream |
Una instantánea de un recurso de DataStream en el historial de cambios. |