- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- AttributeMetadata
- AttributeValueMetadata
Restituisce l'elenco di attributi che sarebbero disponibili per una località con il paese e la categoria principali specificati.
Richiesta HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1/attributes
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
Parametri | |
---|---|
parent |
Nome della risorsa della località per cercare gli attributi disponibili. Se questo campo è impostato, categoriaName, RegionCode, languageCode e showAll non sono obbligatori e non devono essere impostati. |
categoryName |
L'ID stabile della categoria principale per trovare gli attributi disponibili. Deve essere del formato categorie/{category_id}. |
regionCode |
Il codice paese ISO 3166-1 alpha-2 per trovare gli attributi disponibili. |
languageCode |
Il codice della lingua BCP 47 in cui inserire i nomi visualizzati degli attributi. Se questa lingua non è disponibile, verranno fornite in inglese. |
showAll |
I metadati per tutti gli attributi disponibili vengono restituiti quando questo campo è impostato su true, senza considerare i campi padre e categoriaNome. languageCode e RegionCode sono obbligatori se showAll è impostato su true. |
pageSize |
Il numero di attributi da includere per pagina. Il valore predefinito è 200, il minimo è 1. |
pageToken |
Se specificato, viene recuperata la pagina successiva dei metadati degli attributi. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Risposta per AttributesService.ListAttributeMetadata.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"attributeMetadata": [
{
object ( |
Campi | |
---|---|
attributeMetadata[] |
Una raccolta di metadati degli attributi per gli attributi disponibili. |
nextPageToken |
Se il numero di attributi supera le dimensioni di pagina richieste, questo campo verrà compilato con un token per recuperare la pagina successiva di attributi in una chiamata successiva a |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/business.manage
Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
AttributeMetadata
Metadati relativi a un attributo. Contiene le informazioni di visualizzazione per l'attributo, tra cui un nome localizzato e un'intestazione per raggruppare gli attributi correlati.
Rappresentazione JSON |
---|
{ "parent": string, "valueType": enum ( |
Campi | |
---|---|
parent |
L'identificatore univoco dell'attributo. |
valueType |
Il tipo di valore dell'attributo. I valori impostati e recuperati dovrebbero essere di questo tipo. |
displayName |
Il nome visualizzato localizzato dell'attributo, se disponibile. altrimenti il nome visualizzato in inglese. |
groupDisplayName |
Il nome visualizzato localizzato del gruppo che contiene questo attributo, se disponibile. altrimenti il nome del gruppo in inglese. Gli attributi correlati vengono raccolti in un gruppo e devono essere visualizzati insieme sotto l'intestazione qui fornita. |
repeatable |
Se true, l'attributo supporta più valori. Se false, è necessario fornire un solo valore. |
valueMetadata[] |
Per alcuni tipi di attributi (ad esempio le enum), viene fornito un elenco di valori supportati e dei relativi nomi visualizzati. |
deprecated |
Se impostato su true, l'attributo è obsoleto e non deve più essere utilizzato. Se deprecato, l'aggiornamento di questo attributo non genererà un errore, ma gli aggiornamenti non verranno salvati. A un certo punto, dopo essere stato deprecato, l'attributo verrà rimosso completamente e diventerà un errore. |
AttributeValueMetadata
Metadati per i valori degli attributi supportati.
Rappresentazione JSON |
---|
{ "value": value, "displayName": string } |
Campi | |
---|---|
value |
Il valore dell'attributo. |
displayName |
Il nome visualizzato di questo valore, localizzato dove disponibile; altrimenti in inglese. Il nome visualizzato del valore deve essere utilizzato nel contesto del nome visualizzato dell'attributo. Ad esempio, per una connessione "Wi-Fi" attributo enum, potrebbe contenere "Pagato" per rappresentare le reti Wi-Fi a pagamento. |