REST Resource: properties

Recurso: Property

Un mensaje de recurso que representa una propiedad GA4 de Google Analytics.

Representación 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
}
Campos
name

string

Solo salida. Es el nombre del recurso de esta propiedad. Formato: properties/{property_id} Ejemplo: "properties/1000"

propertyType

enum (PropertyType)

Inmutable. El tipo de propiedad para este recurso de propiedad. Cuando creas una propiedad, si el tipo es “PROPERTY_TYPE_UNSPECIFIED”, entonces “ORDINARY_PROPERTY” serán implícitas.

createTime

string (Timestamp format)

Solo salida. Hora en la que se creó la entidad originalmente.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo salida. Hora en la que se actualizaron por última vez los campos de carga útil de la entidad.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

parent

string

Inmutable. Nombre del recurso del superior lógico de esta propiedad.

Nota: Se puede usar la IU de traslado de propiedades para cambiar el elemento superior. Formato: cuentas/{cuenta}, propiedades/{propiedad} Ejemplo: "cuentas/100", "propiedades/101"

displayName

string

Obligatorio. Es el nombre visible y legible por humanos de esta propiedad.

La longitud máxima permitida del nombre visible es de 100 unidades de código UTF-16.

industryCategory

enum (IndustryCategory)

Industria asociada con esta propiedad Ejemplo: AUTOMOTIZ, FOOD_AND_DRINK

timeZone

string

Obligatorio. Zona horaria de los informes, que se usa como límite diario para los informes, independientemente de dónde se originen los datos. Si la zona horaria respeta el DST, Analytics se ajustará automáticamente a los cambios.

NOTA: Cambiar la zona horaria solo afecta los datos futuros. No se aplica de forma retroactiva.

Formato: https://www.iana.org/time-zones. Ejemplo: "America/Los_Angeles".

currencyCode

string

Es el tipo de moneda que se usa en los informes que incluyen valores monetarios.

Formato: https://en.wikipedia.org/wiki/ISO_4217. Ejemplos: "USD", "EUR", "JPY"

serviceLevel

enum (ServiceLevel)

Solo salida. Es el nivel de servicio de Google Analytics que se aplica a esta propiedad.

deleteTime

string (Timestamp format)

Solo salida. Si se establece, la hora a la que se envió esta propiedad a la papelera. Si no la estableces, entonces esta propiedad no está en la papelera.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

expireTime

string (Timestamp format)

Solo salida. Si se establece, la hora a la que se borrará de forma permanente esta propiedad que se envió a la papelera. Si no la estableces, esta propiedad no se encuentra en la papelera ni está programada para borrarse.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

account

string

Inmutable. El nombre del recurso de la cuenta principal Formato: accounts/{account_id} Ejemplo: "accounts/123"

PropertyType

Tipos de recursos de propiedad.

Enumeraciones
PROPERTY_TYPE_UNSPECIFIED Tipo de propiedad desconocido o sin especificar
PROPERTY_TYPE_ORDINARY Propiedad GA4 común
PROPERTY_TYPE_SUBPROPERTY Subpropiedad GA4
PROPERTY_TYPE_ROLLUP Propiedad de datos integrados de GA4

IndustryCategory

Es la categoría seleccionada para esta propiedad, que se utiliza en las comparativas de sectores.

Enumeraciones
INDUSTRY_CATEGORY_UNSPECIFIED Categoría del sector sin especificar
AUTOMOTIVE Industria automotriz
BUSINESS_AND_INDUSTRIAL_MARKETS Mercados comerciales e industriales
FINANCE Finanzas
HEALTHCARE Salud
TECHNOLOGY Tecnología
TRAVEL Viajes
OTHER Otro
ARTS_AND_ENTERTAINMENT Arte y entretenimiento
BEAUTY_AND_FITNESS Belleza y bienestar
BOOKS_AND_LITERATURE Libros y literatura
FOOD_AND_DRINK Comidas y bebidas
GAMES Videojuegos
HOBBIES_AND_LEISURE Pasatiempos y ocio
HOME_AND_GARDEN Hogar y jardín
INTERNET_AND_TELECOM Internet y telecomunicaciones
LAW_AND_GOVERNMENT Ley y Gobierno
NEWS Noticias
ONLINE_COMMUNITIES Comunidades online
PEOPLE_AND_SOCIETY Personas y sociedad
PETS_AND_ANIMALS Mascotas y animales
REAL_ESTATE Bienes raíces
REFERENCE Referencia
SCIENCE Ciencia
SPORTS Deportes
JOBS_AND_EDUCATION Trabajos y educación
SHOPPING Compras

ServiceLevel

Varios niveles de servicio de Google Analytics.

Enumeraciones
SERVICE_LEVEL_UNSPECIFIED El nivel de servicio no se especificó o no es válido.
GOOGLE_ANALYTICS_STANDARD La versión estándar de Google Analytics.
GOOGLE_ANALYTICS_360 Es la versión premium pagada de Google Analytics.

Métodos

acknowledgeUserDataCollection

Reconoce las condiciones de la recopilación de datos del usuario para la propiedad especificada.

create

Crea una campaña "GA4". propiedad con la ubicación y los atributos especificados.

delete

Marca la propiedad de destino como borrada de forma no definitiva (es decir, “papelera”) y la muestra.

get

Cómo buscar un solo "GA4" Propiedad.

getDataRetentionSettings

Muestra la configuración de retención de datos singleton de esta propiedad.

list

Devuelve las propiedades secundarias de la cuenta principal especificada.

patch

Actualiza una propiedad.

runAccessReport

Muestra un informe personalizado de los registros de acceso a los datos.

updateDataRetentionSettings

Actualiza la configuración de retención de datos singleton de esta propiedad.