Method: attributes.list

Retorna a lista de atributos que estariam disponíveis para um local com a categoria principal e o país fornecidos.

Solicitação HTTP

GET https://mybusinessbusinessinformation.googleapis.com/v1/attributes

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
parent

string

Nome do recurso do local para procurar os atributos disponíveis. Se este campo estiver definido, "categoryName", "regionCode", "languageCode" e "showAll" não são obrigatórios e não poderão ser definidos.
categoryName

string

O ID estável da categoria principal para encontrar os atributos disponíveis. Precisa estar no formato categorias/{category_id}.
regionCode

string

O código do país ISO 3166-1 alfa-2 para encontrar os atributos disponíveis.
languageCode

string

O código de idioma BCP 47 em que os nomes de exibição do atributo serão exibidos. Se esse idioma não estiver disponível, eles serão fornecidos em inglês.
showAll

boolean

Os metadados de todos os atributos disponíveis são retornados quando esse campo é definido como verdadeiro, desconsiderando os campos "parent" e "categoryName". languageCode e regionCode são obrigatórios quando showAll é definido como verdadeiro.
pageSize

integer

Quantos atributos incluir por página. O padrão é 200, e o mínimo é 1.
pageToken

string

Se especificado, a próxima página de metadados do atributo é recuperada.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta para AttributesService.ListAttributeMetadata.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "attributeMetadata": [
    {
      object (AttributeMetadata)
    }
  ],
  "nextPageToken": string
}
Campos
attributeMetadata[]

object (AttributeMetadata)

Uma coleção de metadados de atributos para os atributos disponíveis.
nextPageToken

string

Se o número de atributos exceder o tamanho da página solicitado, esse campo será preenchido com um token para buscar a próxima página de atributos em uma chamada subsequente para attributes.list. Se não houver mais atributos, este campo não estará presente na resposta.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/business.manage

Para mais informações, consulte a Visão geral do OAuth 2.0.

AttributeMetadata

Metadados de um atributo. Contém informações de exibição para o atributo, incluindo um nome localizado e um título para agrupar atributos relacionados.

Representação JSON 
{
  "parent": string,
  "valueType": enum (AttributeValueType),
  "displayName": string,
  "groupDisplayName": string,
  "repeatable": boolean,
  "valueMetadata": [
    {
      object (AttributeValueMetadata)
    }
  ],
  "deprecated": boolean
}
Campos
parent

string

O identificador exclusivo do atributo.
valueType

enum (AttributeValueType)

O tipo de valor para o atributo. Os valores definidos e recuperados devem ser desse tipo.
displayName

string

o nome de exibição localizado do atributo, se disponível; caso contrário, o nome de exibição em inglês.
groupDisplayName

string

o nome de exibição localizado do grupo que contém esse atributo, se disponível; caso contrário, o nome do grupo em inglês. Os atributos relacionados são coletados em um grupo e devem ser exibidos juntos sob o título fornecido aqui.
repeatable

boolean

Se verdadeiro, o atributo aceita vários valores. Se for falso, apenas um valor deverá ser fornecido.
valueMetadata[]

object (AttributeValueMetadata)

Para alguns tipos de atributos (por exemplo, tipos enumerados), é fornecida uma lista de valores compatíveis e nomes de exibição correspondentes a esses valores.
deprecated

boolean

Se for verdadeiro, o atributo será descontinuado e não deverá mais ser usado. Se ele for descontinuado, a atualização deste atributo não vai resultar em erro, mas as atualizações não serão salvas. Em algum momento após ser descontinuado, o atributo será totalmente removido e se tornará um erro.

AttributeValueMetadata

Metadados dos valores de atributo compatíveis.

Representação JSON 
{
  "value": value,
  "displayName": string
}
Campos
value

value (Value format)

O valor do atributo.
displayName

string

O nome de exibição desse valor, localizado quando disponível. em inglês. O nome de exibição do valor deve ser usado em contexto com o nome de exibição do atributo.

Por exemplo, para uma rede Wi-Fi, atributo enum, que pode conter "Pago" para representar o Wi-Fi pago.