REST Resource: properties

Recurso: propriedade

Uma mensagem de recurso que representa uma propriedade do Google Analytics.

Representação 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

Identificador. Nome do recurso dessa propriedade. Formato: properties/{property_id} Exemplo: "properties/1000"

propertyType

enum (PropertyType)

Imutável. O tipo de propriedade desse recurso. Ao criar uma propriedade, se o tipo for "PROPERTY_TYPE_UNSPECIFIED", "ORDINARY_PROPERTY" será implícito.

createTime

string (Timestamp format)

Apenas saída. Hora em que a entidade foi criada originalmente.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Apenas saída. Hora em que os campos de payload da entidade foram atualizados pela última vez.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

parent

string

Imutável. Nome do recurso do pai lógico dessa propriedade.

Observação: a interface de movimentação de propriedades pode ser usada para mudar o pai. Formato: accounts/{account}, properties/{property} Exemplo: "accounts/100", "properties/101"

displayName

string

Obrigatório. Nome de exibição legível para essa propriedade.

O tamanho máximo permitido do nome de exibição é de 100 unidades de código UTF-16.

industryCategory

enum (IndustryCategory)

Setor associado a essa propriedade. Exemplo: AUTOMOTIVE, FOOD_AND_DRINK

timeZone

string

Obrigatório. Fuso horário de relatórios, usado como o limite do dia para relatórios, independentemente da origem dos dados. Se o fuso horário seguir o horário de verão, o Google Analytics vai ajustar automaticamente as mudanças.

OBSERVAÇÃO: a mudança do fuso horário só afeta dados posteriores, não sendo aplicada de forma retroativa.

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

currencyCode

string

O tipo de moeda usado em relatórios que envolvem valores monetários.

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

serviceLevel

enum (ServiceLevel)

Apenas saída. O nível de serviço do Google Analytics que se aplica a essa propriedade.

deleteTime

string (Timestamp format)

Apenas saída. Se definido, a hora em que essa propriedade foi movida para a lixeira. Se não estiver definido, essa propriedade não estará na lixeira.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

expireTime

string (Timestamp format)

Apenas saída. Se definido, a hora em que essa propriedade movida para a lixeira será excluída permanentemente. Se não estiver definido, essa propriedade não estará na lixeira e não será excluída.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

account

string

Imutável. O nome do recurso da conta mãe. Formato: accounts/{account_id} Exemplo: "accounts/123"

PropertyType

Tipos de recursos Property.

Tipos enumerados
PROPERTY_TYPE_UNSPECIFIED Tipo de propriedade desconhecido ou não especificado
PROPERTY_TYPE_ORDINARY Propriedade comum do Google Analytics
PROPERTY_TYPE_SUBPROPERTY Subpropriedade do Google Analytics
PROPERTY_TYPE_ROLLUP Propriedade de visualização completa do Google Analytics

IndustryCategory

A categoria selecionada para essa propriedade, usada para comparações de mercado.

Tipos enumerados
INDUSTRY_CATEGORY_UNSPECIFIED Categoria do setor não especificada
AUTOMOTIVE Automóveis
BUSINESS_AND_INDUSTRIAL_MARKETS Mercados comercial e industrial
FINANCE Finanças
HEALTHCARE Saúde
TECHNOLOGY Tecnologia
TRAVEL Viagem
OTHER Outro
ARTS_AND_ENTERTAINMENT Artes e entretenimento
BEAUTY_AND_FITNESS Beleza e bem-estar
BOOKS_AND_LITERATURE Livros e literatura
FOOD_AND_DRINK Alimentos e bebidas
GAMES Jogos
HOBBIES_AND_LEISURE Hobbies e lazer
HOME_AND_GARDEN Casa e jardim
INTERNET_AND_TELECOM Internet e telecomunicações
LAW_AND_GOVERNMENT Legislação e governo
NEWS Notícias
ONLINE_COMMUNITIES Comunidades on-line
PEOPLE_AND_SOCIETY Pessoas e sociedade
PETS_AND_ANIMALS Animais de estimação e outros animais
REAL_ESTATE Imóveis
REFERENCE Referência
SCIENCE Ciência
SPORTS Esportes
JOBS_AND_EDUCATION Empregos e educação
SHOPPING Shopping

ServiceLevel

Vários níveis de serviço do Google Analytics.

Tipos enumerados
SERVICE_LEVEL_UNSPECIFIED Nível de serviço não especificado ou inválido.
GOOGLE_ANALYTICS_STANDARD A versão padrão do Google Analytics.
GOOGLE_ANALYTICS_360 A versão paga e premium do Google Analytics.

Métodos

acknowledgeUserDataCollection

Confirma os termos de coleta de dados do usuário para a propriedade especificada.

create

Cria uma propriedade do Google Analytics com o local e os atributos especificados.

delete

Marca a propriedade de destino como excluída temporariamente (ou seja, "movida para a lixeira") e a retorna.

get

Pesquisa uma única propriedade do GA.

getDataRetentionSettings

Retorna as configurações de retenção de dados singleton para essa propriedade.

list

Retorna as propriedades filhas na conta mãe especificada.

patch

Atualiza uma propriedade.

runAccessReport

Retorna um relatório personalizado de registros de acesso aos dados.

updateDataRetentionSettings

Atualiza as configurações de retenção de dados singleton para essa propriedade.