REST Resource: properties

Recurso: Propiedad

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 la propiedad. Cuando se crea una propiedad, si el tipo es "PROPERTY_TYPE_UNSPECIFIED", entonces "ORDINARY_PROPERTY" está implícito.

createTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con 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 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 elemento superior lógico de esta propiedad.

Nota: Se puede usar la IU de traslado de propiedades para cambiar el elemento superior. Formato: accounts/{account}, properties/{property} Ejemplo: "accounts/100", "properties/101"

displayName

string

Obligatorio. Es el nombre visible legible 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: AUTOMOTIVE, FOOD_AND_DRINK

timeZone

string

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

NOTA: Cambiar la zona horaria solo afecta los datos futuros y 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” o “JPY”

serviceLevel

enum (ServiceLevel)

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

deleteTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con 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 configura, la hora a la que esta propiedad enviada a la papelera se borrará de forma permanente. Si no la estableces, esta propiedad no está actualmente en la papelera y no se borrará.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con 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 propiedades.

Enumeradores
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 GA4

IndustryCategory

La categoría seleccionada para esta propiedad, que se usa en las comparativas de sectores.

Enumeradores
INDUSTRY_CATEGORY_UNSPECIFIED Categoría del sector sin especificar
AUTOMOTIVE Industria automotriz
BUSINESS_AND_INDUSTRIAL_MARKETS Mercados industriales y comerciales
FINANCE Finanzas
HEALTHCARE Servicios de salud
TECHNOLOGY Tecnología
TRAVEL Viajes
OTHER Otra opción
ARTS_AND_ENTERTAINMENT Arte y entretenimiento
BEAUTY_AND_FITNESS Belleza y bienestar
BOOKS_AND_LITERATURE Libros y literatura
FOOD_AND_DRINK Alimentos y bebidas
GAMES Juegos
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 Reference
SCIENCE Ciencia
SPORTS Deportes
JOBS_AND_EDUCATION Trabajos y educación
SHOPPING Compras

ServiceLevel

Varios niveles de servicio para Google Analytics.

Enumeradores
SERVICE_LEVEL_UNSPECIFIED Nivel de servicio no especificado o no válido.
GOOGLE_ANALYTICS_STANDARD Es la versión estándar de Google Analytics.
GOOGLE_ANALYTICS_360 Es la versión premium pagada de Google Analytics.

Métodos

acknowledgeUserDataCollection

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

create

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

delete

Marca la propiedad objetivo como borrada de forma no definitiva (es decir: "enviada a la papelera") y la muestra.

get

Busca una sola propiedad "GA4".

getDataRetentionSettings

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

list

Devuelve Propiedades secundarias bajo la cuenta principal especificada.

patch

Actualiza una propiedad.

runAccessReport

Devuelve 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.