- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- ChangeHistoryResourceType
- ActionType
- ChangeHistoryEvent
- ActorType
- ChangeHistoryChange
- ChangeHistoryResource
- Essayer
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 |
Obligatoire. Ressource de compte pour laquelle afficher les ressources de l'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 ( |
Champs | |
---|---|
property |
Facultatif. Nom de ressource d'une propriété enfant. Si cet indicateur est défini, ne renvoie que les modifications apportées à cette propriété ou à ses ressources enfants. |
resourceType[] |
Facultatif. Si cette valeur est définie, ne renvoie les modifications que si elles concernent une ressource correspondant à au moins l'un de ces types. |
action[] |
Facultatif. Si cet indicateur est défini, ne renvoie que les modifications qui correspondent à un ou plusieurs de ces types d'actions. |
actorEmail[] |
Facultatif. Si cet indicateur est défini, ne renvoie les modifications que si elles sont effectuées par un utilisateur de cette liste. |
earliestChangeTime |
Facultatif. Si cette valeur est définie, elle ne renvoie que les modifications apportées après cette date (incluse). Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
latestChangeTime |
Facultatif. Si cet indicateur est défini, il ne renvoie que les modifications effectuées avant cette date (incluse). Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
pageSize |
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, 50 articles au maximum seront renvoyés. La valeur maximale est 200 (les valeurs plus élevées sont forcées au maximum). |
pageToken |
Facultatif. Jeton de page reçu d'un appel |
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 ( |
Champs | |
---|---|
changeHistoryEvents[] |
Résultats auxquels l'appelant avait accès. |
nextPageToken |
Jeton pouvant être envoyé en tant que |
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é |
FIREBASE_LINK |
Ressource FirebaseLink |
GOOGLE_ADS_LINK |
Ressource GoogleAdsLink |
GOOGLE_SIGNALS_SETTINGS |
Ressource GoogleSignalsSettings |
CONVERSION_EVENT |
Ressource ConversionEvent |
MEASUREMENT_PROTOCOL_SECRET |
Ressource MeasurementProtocolSecret |
DATA_RETENTION_SETTINGS |
Ressource DataConservationSettings |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
Ressource DisplayVideo360AdvertiserLink |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
Ressource DisplayVideo360AdvertiserLinkProposition |
DATA_STREAM |
Ressource DataStream |
ATTRIBUTION_SETTINGS |
Ressource AttributionSettings |
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 dans cette modification. |
ChangeHistoryEvent
Il s'agit d'un ensemble de modifications dans un compte Google Analytics ou ses propriétés enfants ayant la même cause. Cela peut être dû à des modifications apportées à l'interface utilisateur de Google Analytics, à des modifications apportées par le service client ou à des modifications automatiques du système Google Analytics.
Représentation JSON |
---|
{ "id": string, "changeTime": string, "actorType": enum ( |
Champs | |
---|---|
id |
ID de cet événement de l'historique des modifications. Cet identifiant est unique dans Google Analytics. |
changeTime |
Heure à laquelle la modification a été effectuée. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
actorType |
Type d'acteur ayant effectué la modification. |
userActorEmail |
Adresse e-mail du compte Google ayant effectué la modification. Cette adresse e-mail sera valide si le champ de l'acteur est défini sur UTILISATEUR. Sinon, il sera vide. Les comptes Google supprimés généreront une erreur. |
changesFiltered |
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[] |
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 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 ( |
Champs | |
---|---|
resource |
Nom de la ressource dont les modifications sont décrites par cette entrée. |
action |
Type d'action qui a modifié cette ressource. |
resourceBeforeChange |
Contenu des ressources antérieur à la modification. Si cette ressource a été créée lors de cette modification, ce champ sera manquant. |
resourceAfterChange |
Contenu des ressources 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 |
Champs | |
---|---|
Champ d'union
|
|
account |
Instantané d'une ressource "Account" dans l'historique des modifications. |
property |
Instantané d'une ressource de propriété dans l'historique des modifications. |
firebaseLink |
Instantané d'une ressource FirebaseLink dans l'historique des modifications. |
googleAdsLink |
Instantané d'une ressource GoogleAdsLink dans l'historique des modifications. |
conversionEvent |
Instantané d'une ressource ConversionEvent dans l'historique des modifications. |
measurementProtocolSecret |
Instantané d'une ressource MeasurementProtocolSecret dans l'historique des modifications. |
dataRetentionSettings |
Instantané d'une ressource de paramètres de conservation des données dans l'historique des modifications. |
dataStream |
Instantané d'une ressource DataStream dans l'historique des modifications. |