Method: accounts.searchChangeHistoryEvents

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/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 afficher 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 valeur est définie, ne renvoie que les modifications apportées à cette propriété ou à ses ressources enfants. Format: properties/{propertyId}. Exemple: "properties/100"
resourceType[]

enum (ChangeHistoryResourceType)

Facultatif. Si ce champ est défini, ne renvoie les modifications que si elles concernent une ressource correspondant à au moins l'un de ces types.
action[]

enum (ActionType)

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

string

Facultatif. Si cette règle est définie, ne renvoie les modifications que si elles sont effectuées par un utilisateur de cette liste.
earliestChangeTime

string (Timestamp format)

Facultatif. Si cette valeur est définie, elle ne renvoie que les modifications apportées après ce délai (inclus).

Code temporel 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 cette valeur est définie, elle ne renvoie que les modifications apportées avant cette date (incluse).

Code temporel 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 à renvoyer. 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, au maximum 50 articles seront renvoyés. La valeur maximale est 200 (les valeurs plus élevées sont forcées à atteindre le 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 qui a 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 le niveau d'accès OAuth suivant :

  • 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 du compte
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 DataConservationSettings
DATA_STREAM Ressource DataStream
ATTRIBUTION_SETTINGS Ressource AttributionSettings
EXPANDED_DATA_SET Ressource ExpandedDataSet
CHANNEL_GROUP Ressource ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS Ressource AdvancedMeasurementSettings
DATA_REDACTION_SETTINGS Ressource DataRedactionSettings
SKADNETWORK_CONVERSION_VALUE_SCHEMA Ressource SKAdNetworkConversionValueSchema
AUDIENCE Ressource d'audience
EVENT_CREATE_RULE Ressource EventCreateRule
CALCULATED_METRIC Ressource CalculatedMetric

ActionType

Types d'actions susceptibles de modifier une ressource.

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

ChangeHistoryEvent

Il s'agit d'un ensemble de modifications apportées à un compte Google Analytics ou à ses propriétés enfants qui ont été générées par la même cause. Cela peut être dû à des mises à jour dans l'interface utilisateur de Google Analytics, à des changements effectués par le service client ou à des 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 identifiant est unique dans Google Analytics.
changeTime

string (Timestamp format)

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

Code temporel 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 la modification.
userActorEmail

string

Adresse e-mail du compte Google à l'origine de la modification. Il s'agit d'une adresse e-mail valide si le champ "actor" est défini sur "USER" (Utilisateur), et vide dans le cas contraire. Les comptes Google supprimés généreront 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 qui correspondent aux filtres spécifiés dans SearchChangeHistoryEventsRequest.

ActorType

Les différents types d'acteurs pouvant apporter des modifications aux 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

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 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)

Contenus de ressources antérieurs à la modification. Si cette ressource a été créée lors de cette modification, ce champ sera manquant.
resourceAfterChange

object (ChangeHistoryResource)

Contenu de la ressource postérieur à la modification. Si cette ressource a été supprimée lors de cette modification, ce champ sera manquant.

ChangeHistoryResource

Instantané d'une ressource tel qu'avant ou après le résultat d'une modification de 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)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  }
  // 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 "Compte" dans l'historique des modifications.
property

object (Property)

Instantané d'une ressource Property 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 d'audience dans l'historique des modifications.
eventCreateRule

object (EventCreateRule)

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

object (CalculatedMetric)

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