- 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 (Type de ressource ChangeHistory)
- ActionType (Type d'action)
- ChangeHistoryEvent
- Type d'utilisateur
- 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 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 ( |
Champs | |
---|---|
property |
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[] |
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[] |
Facultatif. Si ce champ est défini, n'affiche que les modifications correspondant à un ou plusieurs de ces types d'actions. |
actorEmail[] |
Facultatif. Si ce champ est défini, n'affiche les modifications que si elles sont effectuées par un utilisateur de cette liste. |
earliestChangeTime |
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: |
latestChangeTime |
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: |
pageSize |
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 |
Facultatif. Jeton de page reçu d'un appel |
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 ( |
Champs | |
---|---|
changeHistoryEvents[] |
Résultats accessibles à l'appelant. |
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
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é |
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 DisplayVideo360AnnonceurLink |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
Ressource DisplayVideo360AnnonceurLinkProposition |
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 ( |
Champs | |
---|---|
id |
ID de cet événement de l'historique des modifications. Il est unique dans Google Analytics. |
changeTime |
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: |
actorType |
Type d'acteur à l'origine de cette évolution. |
userActorEmail |
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 |
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 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 ( |
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 datant d'avant la modification. Si cette ressource a été créée suite à cette modification, ce champ est manquant. |
resourceAfterChange |
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 |
Champs | |
---|---|
Champ d'union
|
|
account |
Instantané d'une ressource "Account" dans l'historique des modifications. |
property |
Instantané d'une ressource 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 des paramètres de conservation des données dans l'historique des modifications. |
dataStream |
Instantané d'une ressource DataStream dans l'historique des modifications. |