REST Resource: properties

Ressource: Property

Message de ressource représentant une propriété GA4 Google Analytics.

Représentation JSON
{
  "name": string,
  "propertyType": enum (PropertyType),
  "createTime": string,
  "updateTime": string,
  "parent": string,
  "displayName": string,
  "industryCategory": enum (IndustryCategory),
  "timeZone": string,
  "currencyCode": string,
  "serviceLevel": enum (ServiceLevel),
  "deleteTime": string,
  "expireTime": string,
  "account": string
}
Champs
name

string

Uniquement en sortie. Nom de ressource de cette propriété. Format: properties/{property_id} Exemple: "properties/1000"

propertyType

enum (PropertyType)

Immuable. Type de propriété pour cette ressource Property. Lors de la création d'une propriété, si le type est "PROPERTY_TYPE_UNSPECIFIED", alors "ORDINARY_PROPERTY" sera implicite. Les types "SUBPROPERTY" et "ROLLUP_PROPERTY" ne peuvent pas encore être créés avec l'API Admin de Google Analytics.

createTime

string (Timestamp format)

Uniquement en sortie. Heure de création initiale de l'entité.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Uniquement en sortie. Heure de la dernière mise à jour des champs de charge utile d'entité.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

parent

string

Immuable. Nom de ressource du parent logique de cette propriété.

Remarque: Vous pouvez utiliser l'interface utilisateur de déplacement de propriétés pour modifier le parent. Format: accounts/{compte}, propriétés/{propriété} Exemple: "comptes/100", "propriétés/101"

displayName

string

Obligatoire. Nom lisible à afficher pour cette propriété.

La longueur maximale autorisée pour le nom à afficher est de 100 unités de code UTF-16.

industryCategory

enum (IndustryCategory)

Secteur associé à cette propriété Exemple: AUTOMOTIVE, FOOD_AND_DRINK

timeZone

string

Obligatoire. Fuseau horaire utilisé dans les rapports, utilisé comme limite quotidienne et ce, quelle que soit l'origine des données. Si le fuseau horaire respecte l'heure d'été, Analytics ajuste automatiquement les modifications en fonction.

REMARQUE: La modification du fuseau horaire ne concerne que les données à venir. Elle n'est pas rétroactive.

Format: https://www.iana.org/time-zones Exemple: "America/Los_Angeles"

currencyCode

string

Type de devise utilisé dans les rapports impliquant des valeurs monétaires.

Format: https://fr.wikipedia.org/wiki/ISO_4217Exemples: "USD", "EUR", "JPY"

serviceLevel

enum (ServiceLevel)

Uniquement en sortie. Niveau de service Google Analytics qui s'applique à cette propriété.

deleteTime

string (Timestamp format)

Uniquement en sortie. Si ce champ est défini, il s'agit de l'heure à laquelle cette propriété a été placée dans la corbeille. Si cette propriété n'est pas définie, cette propriété ne se trouve pas dans la corbeille.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

expireTime

string (Timestamp format)

Uniquement en sortie. Si cette option est définie, l'heure à laquelle cette propriété placée dans la corbeille sera supprimée définitivement. Si cette propriété n'est pas définie, cette propriété ne se trouve pas dans la corbeille et ne sera pas supprimée.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

account

string

Immuable. Nom de ressource du compte parent. Format: accounts/{account_id}. Exemple: "accounts/123"

Type de propriété

Types de ressources Property.

Enums
PROPERTY_TYPE_UNSPECIFIED Type de propriété inconnu ou non spécifié
PROPERTY_TYPE_ORDINARY Propriété GA4 ordinaire
PROPERTY_TYPE_SUBPROPERTY Sous-propriété GA4
PROPERTY_TYPE_ROLLUP Propriété de consolidation GA4

Catégorie

Catégorie sélectionnée pour cette propriété, utilisée pour l'analyse comparative du secteur.

Enums
INDUSTRY_CATEGORY_UNSPECIFIED Catégorie sectorielle non spécifiée
AUTOMOTIVE Automobile
BUSINESS_AND_INDUSTRIAL_MARKETS Commerce et industrie
FINANCE Finance
HEALTHCARE Santé
TECHNOLOGY Technologie
TRAVEL Voyage
OTHER Autre
ARTS_AND_ENTERTAINMENT Arts et divertissements
BEAUTY_AND_FITNESS Soins du corps et remise en forme
BOOKS_AND_LITERATURE Livres et littérature
FOOD_AND_DRINK Alimentation et boissons
GAMES Jeux
HOBBIES_AND_LEISURE Hobbies et loisirs
HOME_AND_GARDEN Maison et jardinage
INTERNET_AND_TELECOM Internet et télécoms
LAW_AND_GOVERNMENT Justice et administrations
NEWS Actualités
ONLINE_COMMUNITIES Communautés en ligne
PEOPLE_AND_SOCIETY Individus et société
PETS_AND_ANIMALS Animaux
REAL_ESTATE Immobilier
REFERENCE Reference
SCIENCE La science
SPORTS Sport
JOBS_AND_EDUCATION Emploi et enseignement
SHOPPING Shopping

Niveau de service

Différents niveaux de service pour Google Analytics.

Enums
SERVICE_LEVEL_UNSPECIFIED Niveau de service non spécifié ou non valide.
GOOGLE_ANALYTICS_STANDARD Version standard de Google Analytics
GOOGLE_ANALYTICS_360 Version payante premium de Google Analytics

Méthodes

acknowledgeUserDataCollection

Accepte les conditions de la collecte des données utilisateur pour la propriété spécifiée.

create

Crée une propriété "GA4" avec l'emplacement et les attributs spécifiés.

delete

Marque la propriété cible comme étant supprimée de façon réversible (par exemple, "Corbeille") et la renvoie.

get

Recherchez une seule propriété "GA4".

getDataRetentionSettings

Renvoie les paramètres de conservation des données singleton pour cette propriété.

list

Renvoie les propriétés enfants sous le compte parent spécifié.

patch

Met à jour une propriété.

runAccessReport

Renvoie un rapport personnalisé sur les enregistrements d'accès aux données.

updateDataRetentionSettings

Met à jour les paramètres de conservation des données singleton pour cette propriété.