Method: accounts.searchChangeHistoryEvents

Effectue une recherche dans toutes les modifications apportées à un compte ou à ses enfants en fonction de l'ensemble de filtres spécifié.

Requête HTTP :

POST https://analyticsadmin.googleapis.com/v1beta/{account=accounts/*}:searchChangeHistoryEvents

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
account

string

Obligatoire. Ressource de compte pour laquelle renvoyer des ressources d'historique des modifications.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "property": string,
  "resourceType": [
    enum (ChangeHistoryResourceType)
  ],
  "action": [
    enum (ActionType)
  ],
  "actorEmail": [
    string
  ],
  "earliestChangeTime": string,
  "latestChangeTime": string,
  "pageSize": integer,
  "pageToken": string
}
Champs
property

string

Facultatif. Nom de ressource d'une propriété enfant. S'il est défini, ne renvoie que les modifications apportées à cette propriété ou à ses ressources enfants.

resourceType[]

enum (ChangeHistoryResourceType)

Facultatif. Si la règle est définie, elle ne renvoie les modifications que si elles concernent une ressource correspondant à au moins l'un de ces types.

action[]

enum (ActionType)

Facultatif. Si ce champ est défini, n'affiche que les modifications correspondant à un ou plusieurs de ces types d'actions.

actorEmail[]

string

Facultatif. Si ce champ est défini, n'affiche les modifications que si elles sont effectuées par un utilisateur de cette liste.

earliestChangeTime

string (Timestamp format)

Facultatif. Si ce champ est défini, seules les modifications effectuées après cette date sont renvoyées.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

latestChangeTime

string (Timestamp format)

Facultatif. Si ce champ est défini, seules les modifications effectuées avant cette date sont incluses.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

pageSize

integer

Facultatif. Nombre maximal d'éléments ChangeHistoryEvent à afficher. Le service peut renvoyer une valeur inférieure à cette valeur, même s'il existe des pages supplémentaires. Si aucune valeur n'est spécifiée, la recherche affiche 50 articles au maximum. La valeur maximale est 200 (les valeurs supérieures seront converties au maximum).

pageToken

string

Facultatif. Jeton de page reçu d'un appel accounts.searchChangeHistoryEvents précédent. Fournissez-le pour récupérer la page suivante. Lors de la pagination, tous les autres paramètres fournis à accounts.searchChangeHistoryEvents doivent correspondre à l'appel ayant fourni le jeton de page.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Message de réponse pour le RPC SearchAccounts.

Représentation JSON
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
Champs
changeHistoryEvents[]

object (ChangeHistoryEvent)

Résultats accessibles à l'appelant.

nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/analytics.edit

Type de ressource "ChangeHistoryResource"

Types de ressources dont les modifications peuvent être renvoyées par l'historique des modifications.

Enums
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED Type de ressource inconnu ou non spécifié.
ACCOUNT Ressource associée au compte
PROPERTY Ressource de la propriété
GOOGLE_SIGNALS_SETTINGS Ressource GoogleSignalsSettings
CONVERSION_EVENT Ressource ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Ressource MeasurementProtocolSecret
DATA_RETENTION_SETTINGS Ressource DataConservationSettings
DATA_STREAM Ressource DataStream
ATTRIBUTION_SETTINGS Ressource AttributionSettings

Type d'action

Types d'actions susceptibles de modifier une ressource.

Enums
ACTION_TYPE_UNSPECIFIED Type d'action inconnu ou non spécifié.
CREATED Une ressource a été créée pour cette modification.
UPDATED Cette ressource a été mise à jour.
DELETED Cette ressource a été supprimée.

Événement de l'historique des modifications

Ensemble de modifications apportées à un compte Google Analytics ou à ses propriétés enfants d'une même cause. Il peut s'agir de modifications apportées dans l'UI Google Analytics, de modifications du service client ou de modifications automatiques du système Google Analytics.

Représentation JSON
{
  "id": string,
  "changeTime": string,
  "actorType": enum (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
Champs
id

string

ID de cet événement de l'historique des modifications. Il est unique dans Google Analytics.

changeTime

string (Timestamp format)

Heure à laquelle la modification a été effectuée.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

actorType

enum (ActorType)

Type d'acteur à l'origine de cette évolution.

userActorEmail

string

Adresse e-mail du compte Google à l'origine de la modification. Cette adresse e-mail sera valide si le champ "actor" (utilisateur) est défini sur USER (Utilisateur), et est vide dans le cas contraire. Les comptes Google supprimés entraînent une erreur.

changesFiltered

boolean

Si la valeur est "true", la liste des modifications renvoyées a été filtrée et ne représente pas toutes les modifications survenues dans cet événement.

changes[]

object (ChangeHistoryChange)

Liste des modifications apportées à cet événement de l'historique des modifications et correspondant aux filtres spécifiés dans SearchChangeHistoryEventsRequest.

Type d'utilisateur

Différents types d'acteurs autorisés à modifier les ressources Google Analytics.

Enums
ACTOR_TYPE_UNSPECIFIED Type d'acteur inconnu ou non spécifié.
USER Modifications apportées par l'utilisateur spécifié dans actorEmail.
SYSTEM Modifications apportées par le système Google Analytics.
SUPPORT Modifications apportées par le personnel de l'équipe d'assistance Google Analytics

Modifier l'historique des modifications

Description d'une modification apportée à une seule ressource Google Analytics.

Représentation JSON
{
  "resource": string,
  "action": enum (ActionType),
  "resourceBeforeChange": {
    object (ChangeHistoryResource)
  },
  "resourceAfterChange": {
    object (ChangeHistoryResource)
  }
}
Champs
resource

string

Nom de la ressource dont les modifications sont décrites par cette entrée.

action

enum (ActionType)

Type d'action qui a modifié cette ressource.

resourceBeforeChange

object (ChangeHistoryResource)

Contenu des ressources datant d'avant la modification. Si cette ressource a été créée suite à cette modification, ce champ est manquant.

resourceAfterChange

object (ChangeHistoryResource)

Contenu de la ressource datant après la modification. Si cette ressource a été supprimée, ce champ est manquant.

Ressource de l'historique des modifications

Instantané d'une ressource, avant ou après le résultat d'une modification dans l'historique des modifications.

Représentation JSON
{

  // Union field resource can be only one of the following:
  "account": {
    object (Account)
  },
  "property": {
    object (Property)
  },
  "firebaseLink": {
    object (FirebaseLink)
  },
  "googleAdsLink": {
    object (GoogleAdsLink)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "dataStream": {
    object (DataStream)
  }
  // End of list of possible types for union field resource.
}
Champs

Champ d'union resource.

resource ne peut être qu'un des éléments suivants :

account

object (Account)

Instantané d'une ressource "Account" dans l'historique des modifications.

property

object (Property)

Instantané d'une ressource Propriété dans l'historique des modifications.

conversionEvent

object (ConversionEvent)

Instantané d'une ressource ConversionEvent dans l'historique des modifications.

measurementProtocolSecret

object (MeasurementProtocolSecret)

Instantané d'une ressource MeasurementProtocolSecret dans l'historique des modifications.

dataRetentionSettings

object (DataRetentionSettings)

Instantané d'une ressource des paramètres de conservation des données dans l'historique des modifications.

dataStream

object (DataStream)

Instantané d'une ressource DataStream dans l'historique des modifications.