- 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
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. 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 ( |
Champs | |
---|---|
property |
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[] |
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[] |
Facultatif. Si cette valeur est définie, ne renvoie que les modifications qui correspondent à un ou plusieurs de ces types d'actions. |
actorEmail[] |
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 |
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: |
latestChangeTime |
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: |
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, au maximum 50 articles seront renvoyés. La valeur maximale est 200 (les valeurs plus élevées sont forcées à atteindre le 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 DisplayVideo360AdvertiserLinkOffer |
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 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 ( |
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é apportée. Code temporel 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 la modification. |
userActorEmail |
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 |
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 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 ( |
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 |
Contenus de ressources antérieurs à la modification. Si cette ressource a été créée lors de cette modification, ce champ sera manquant. |
resourceAfterChange |
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 |
Champs | |
---|---|
Champ d'union
|
|
account |
Instantané d'une ressource "Compte" dans l'historique des modifications. |
property |
Instantané d'une ressource Property 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. |