Method: accounts.searchChangeHistoryEvents

Recherche toutes les modifications apportées à un compte ou à ses comptes enfants en fonction de l'ensemble de filtres spécifié.

Ne renvoie que le sous-ensemble de modifications compatibles avec l'API. L'UI peut renvoyer des modifications supplémentaires.

Requête HTTP

POST https://analyticsadmin.googleapis.com/v1alpha/{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 les ressources de l'historique des modifications. Format : accounts/{account}

Exemple : accounts/100

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. Si cette option est définie, seules les modifications apportées à cette propriété ou à ses ressources enfants sont renvoyées. Format : properties/{propertyId}

Exemple : properties/100
resourceType[]

enum (ChangeHistoryResourceType)

Facultatif. Si cette option est définie, ne renvoie les modifications que si elles concernent une ressource qui correspond à au moins l'un de ces types.
action[]

enum (ActionType)

Facultatif. Si cette option est définie, ne renvoie que les modifications correspondant à un ou plusieurs de ces types d'actions.
actorEmail[]

string

Facultatif. Si cette option est définie, les modifications ne sont renvoyées que si elles sont apportées par un utilisateur figurant dans cette liste.
earliestChangeTime

string (Timestamp format)

Facultatif. Si cette valeur est définie, seules les modifications apportées après cette heure (incluse) sont renvoyées.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
latestChangeTime

string (Timestamp format)

Facultatif. Si cette valeur est définie, seules les modifications apportées avant cette heure (incluse) sont renvoyées.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
pageSize

integer

Facultatif. Nombre maximal d'éléments ChangeHistoryEvent à renvoyer. Si aucune valeur n'est spécifiée, la recherche affiche 50 éléments au maximum. La valeur maximale est de 200 (les valeurs supérieures seront ramenées à la valeur maximale).

Notez que le service peut renvoyer une page avec un nombre d'éléments inférieur à celui spécifié par cette valeur (voire zéro), et qu'il peut encore y avoir d'autres pages. Si vous souhaitez obtenir un nombre spécifique d'éléments, vous devrez continuer à demander des pages supplémentaires à l'aide de pageToken jusqu'à ce que vous obteniez le nombre souhaité.
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

Message de réponse pour le RPC SearchAccounts.

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

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

object (ChangeHistoryEvent)

Résultats auxquels l'appelant avait accès.
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 l'habilitation OAuth suivante :

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

ChangeHistoryResourceType

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

Enums
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED Type de ressource inconnu ou non spécifié.
ACCOUNT Ressource Account
PROPERTY Ressource de propriété
GOOGLE_SIGNALS_SETTINGS Ressource GoogleSignalsSettings
CONVERSION_EVENT Ressource ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Ressource MeasurementProtocolSecret
CUSTOM_DIMENSION Ressource CustomDimension
CUSTOM_METRIC Ressource CustomMetric
DATA_RETENTION_SETTINGS Ressource DataRetentionSettings
DATA_STREAM Ressource DataStream
ATTRIBUTION_SETTINGS Ressource AttributionSettings
EXPANDED_DATA_SET Ressource ExpandedDataSet
CHANNEL_GROUP Ressource ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS Ressource EnhancedMeasurementSettings
DATA_REDACTION_SETTINGS Ressource DataRedactionSettings
SKADNETWORK_CONVERSION_VALUE_SCHEMA Ressource SKAdNetworkConversionValueSchema
AUDIENCE Ressource d'audience
EVENT_CREATE_RULE Ressource EventCreateRule
KEY_EVENT Ressource KeyEvent
CALCULATED_METRIC Ressource CalculatedMetric
REPORTING_DATA_ANNOTATION Ressource ReportingDataAnnotation
SUBPROPERTY_SYNC_CONFIG Ressource SubpropertySyncConfig
REPORTING_IDENTITY_SETTINGS Ressource ReportingIdentitySettings

ActionType

Types d'actions pouvant modifier une ressource.

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

ChangeHistoryEvent

Ensemble de modifications apportées à un compte Google Analytics ou à ses propriétés enfants, qui sont dues à la même cause. Les causes courantes sont les mises à jour effectuées dans l'UI Google Analytics, les modifications apportées par le service client ou les 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. Cet ID est unique dans Google Analytics.
changeTime

string (Timestamp format)

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

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
actorType

enum (ActorType)

Type d'acteur ayant effectué cette modification.
userActorEmail

string

Adresse e-mail du compte Google qui a effectué la modification. Il s'agit d'une adresse e-mail valide si le champ "acteur" est défini sur "USER", et vide dans le cas contraire. Les comptes Google supprimés génèrent une erreur.
changesFiltered

boolean

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

object (ChangeHistoryChange)

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

ActorType

Différents types d'acteurs pouvant 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 l'équipe d'assistance Google Analytics.

ChangeHistoryChange

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 ressource 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 de la ressource avant la modification. Si cette ressource a été créée lors de cette modification, ce champ sera manquant.
resourceAfterChange

object (ChangeHistoryResource)

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

ChangeHistoryResource

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)
  },
  "googleSignalsSettings": {
    object (GoogleSignalsSettings)
  },
  "displayVideo360AdvertiserLink": {
    object (DisplayVideo360AdvertiserLink)
  },
  "displayVideo360AdvertiserLinkProposal": {
    object (DisplayVideo360AdvertiserLinkProposal)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "customDimension": {
    object (CustomDimension)
  },
  "customMetric": {
    object (CustomMetric)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "searchAds360Link": {
    object (SearchAds360Link)
  },
  "dataStream": {
    object (DataStream)
  },
  "attributionSettings": {
    object (AttributionSettings)
  },
  "expandedDataSet": {
    object (ExpandedDataSet)
  },
  "channelGroup": {
    object (ChannelGroup)
  },
  "bigqueryLink": {
    object (BigQueryLink)
  },
  "enhancedMeasurementSettings": {
    object (EnhancedMeasurementSettings)
  },
  "dataRedactionSettings": {
    object (DataRedactionSettings)
  },
  "skadnetworkConversionValueSchema": {
    object (SKAdNetworkConversionValueSchema)
  },
  "adsenseLink": {
    object (AdSenseLink)
  },
  "audience": {
    object (Audience)
  },
  "eventCreateRule": {
    object (EventCreateRule)
  },
  "keyEvent": {
    object (KeyEvent)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  },
  "reportingDataAnnotation": {
    object (ReportingDataAnnotation)
  },
  "subpropertySyncConfig": {
    object (SubpropertySyncConfig)
  },
  "reportingIdentitySettings": {
    object (ReportingIdentitySettings)
  }
  // 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 de propriété dans l'historique des modifications.
googleSignalsSettings

object (GoogleSignalsSettings)

Instantané d'une ressource GoogleSignalsSettings 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.
customDimension

object (CustomDimension)

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

object (CustomMetric)

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

object (DataRetentionSettings)

Instantané d'une ressource de 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.
attributionSettings

object (AttributionSettings)

Instantané de la ressource AttributionSettings dans l'historique des modifications.
expandedDataSet

object (ExpandedDataSet)

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

object (ChannelGroup)

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

object (EnhancedMeasurementSettings)

Instantané de la ressource EnhancedMeasurementSettings dans l'historique des modifications.
dataRedactionSettings

object (DataRedactionSettings)

Instantané de la ressource DataRedactionSettings dans l'historique des modifications.
skadnetworkConversionValueSchema

object (SKAdNetworkConversionValueSchema)

Instantané de la ressource SKAdNetworkConversionValueSchema dans l'historique des modifications.
audience

object (Audience)

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

object (EventCreateRule)

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

object (KeyEvent)

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

object (CalculatedMetric)

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

object (ReportingDataAnnotation)

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

object (SubpropertySyncConfig)

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

object (ReportingIdentitySettings)

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