REST Resource: accounts

Recurso: Cuenta

Una cuenta es un contenedor para tu ubicación. Si eres el único usuario que administra las ubicaciones de tu empresa, puedes usar tu cuenta personal de Google. Para compartir la administración de las ubicaciones con varios usuarios, crea una cuenta comercial.

Representación JSON
{
  "name": string,
  "accountName": string,
  "primaryOwner": string,
  "type": enum (AccountType),
  "role": enum (AccountRole),
  "verificationState": enum (VerificationState),
  "vettedState": enum (VettedState),
  "accountNumber": string,
  "permissionLevel": enum (PermissionLevel),
  "organizationInfo": {
    object (OrganizationInfo)
  }
}
Campos
name

string

Inmutable. El nombre del recurso, en el formato accounts/{account_id}.

accountName

string

Obligatorio. El nombre de la cuenta. Para una cuenta de tipo PERSONAL, este es el nombre y el apellido de la cuenta de usuario.

primaryOwner

string

Obligatorio. Solo entrada. El nombre de recurso de la cuenta que será el propietario principal de la cuenta que se creará. Debe tener el formato accounts/{account_id}/.

type

enum (AccountType)

Obligatorio. Contiene el tipo de cuenta. Las cuentas de tipo PERSONAL y ORGANIZACIÓN no se pueden crear con esta API.

role

enum (AccountRole)

Solo salida. Especifica el AccountRole de esta cuenta.

verificationState

enum (VerificationState)

Solo salida. Si se verifica, las ubicaciones futuras que se creen se conectarán automáticamente a Google Maps y tendrán páginas de Google+, sin necesidad de moderación.

vettedState

enum (VettedState)

Solo salida. Indica si la cuenta está aprobada por Google. Una cuenta aprobada puede verificar ubicaciones mediante el método VETTED_PARTNER.

accountNumber

string

Solo salida. Número de referencia de la cuenta, si está aprovisionado

permissionLevel

enum (PermissionLevel)

Solo salida. Especifica el nivel de permiso que el usuario tiene para esta cuenta.

organizationInfo

object (OrganizationInfo)

Solo salida. Información adicional sobre una organización. Se propaga solo para una cuenta de organización.

Tipo de cuenta

Indica qué tipo de cuenta es: ya sea una cuenta personal/de usuario o una cuenta comercial.

Enumeradores
ACCOUNT_TYPE_UNSPECIFIED No se especifica.
PERSONAL Una cuenta de usuario final
LOCATION_GROUP Un grupo de ubicaciones. Para obtener más información, consulte el artículo del Centro de ayuda
USER_GROUP Un grupo de usuarios para separar al personal de la organización en grupos. Para obtener más información, consulte el artículo del Centro de ayuda
ORGANIZATION Una organización que representa a una empresa. Para obtener más información, consulte el artículo del Centro de ayuda

Función de cuenta

Indica el nivel de acceso que el usuario autenticado tiene para esta cuenta. Para obtener más información, consulte el artículo del Centro de ayuda

Enumeradores
ACCOUNT_ROLE_UNSPECIFIED No se especifica.
PRIMARY_OWNER El usuario es el propietario principal de esta cuenta.
OWNER El propietario del usuario de la cuenta.
MANAGER El usuario puede administrar esta cuenta.
SITE_MANAGER El usuario puede administrar un conjunto limitado de funciones para la cuenta.

VerificationState

Indica el estado de verificación de la cuenta.

Enumeradores
VERIFICATION_STATE_UNSPECIFIED No se especifica.
VERIFIED Cuenta verificada.
UNVERIFIED Cuenta no verificada y no solicitada
VERIFICATION_REQUESTED Cuenta no verificada, pero que se solicitó.

Estado vetado

Indica el estado aprobado de una cuenta.

Enumeradores
VETTED_STATE_UNSPECIFIED No especificado
NOT_VETTED Google no aprobó la cuenta.
VETTED La cuenta está aprobada por Google y tiene un estado válido. Una cuenta se aprueba automáticamente si tiene acceso directo a una cuenta de grupo verificada.
INVALID La cuenta está aprobada, pero no es válida. La cuenta se comportará como una cuenta sin verificar.

Nivel de permiso

Indica el nivel de acceso que el usuario autenticado tiene para esta cuenta.

Enumeradores
PERMISSION_LEVEL_UNSPECIFIED No se especifica.
OWNER_LEVEL El usuario tiene permiso de nivel de propietario.
MEMBER_LEVEL El usuario tiene permiso de miembro.

Información de la organización

Información adicional almacenada para una organización.

Representación JSON
{
  "registeredDomain": string,
  "address": {
    object (PostalAddress)
  },
  "phoneNumber": string
}
Campos
registeredDomain

string

Solo salida. El dominio registrado para la cuenta.

address

object (PostalAddress)

Solo salida. La dirección postal de la cuenta.

phoneNumber

string

Solo salida. El número de contacto de la organización.

PostalAddress

Representa una dirección postal, p. ej., para envíos postales o direcciones de pago. Si se proporciona una dirección postal, un servicio postal puede enviar artículos a las instalaciones, a la casilla postal o a otras ubicaciones similares. No está diseñado para modelar ubicaciones geográficas (caminos, pueblos, montañas).

En el uso común, una dirección se crearía a través de una entrada del usuario o a partir de la importación de datos existentes, según el tipo de proceso.

Consejos sobre el ingreso o la edición de direcciones: - Usa un widget de dirección listo para la internacionalización como https://github.com/google/libaddressinput) - Los usuarios no deben ver elementos de la IU para ingresar o editar campos fuera de países en los que se usa.

Para obtener orientación sobre cómo usar este esquema, consulta https://support.google.com/business/answer/6397478

Representación JSON
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Campos
revision

integer

La revisión del esquema de PostalAddress. Se debe configurar como 0, que es la última versión.

Todas las revisiones nuevas deben ser compatibles con las revisiones anteriores.

regionCode

string

Obligatorio. Código de región de CLDR para el país o la región de la dirección. Nunca se infiere y depende del usuario garantizar que el valor sea correcto. Para obtener más información, consulta https://cldr.unicode.org/ y https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Ejemplo: "CH" para Suiza.

languageCode

string

Opcional. Código de idioma BCP-47 de los contenidos de esta dirección (si se conoce). Suele ser el idioma de la IU del formulario de entrada o se espera que coincida con uno de los idiomas usados en la región o el país de la dirección, o sus transliteraciones equivalentes. Esto puede afectar el formato en ciertos países, pero no es fundamental para la precisión de los datos y nunca afectará una validación o alguna otra operación no relacionada con el formato.

Si este valor es desconocido, se debe omitir (en lugar de especificar una configuración predeterminada posiblemente incorrecta).

Ejemplos: "zh-Hant", "ja", "ja-Latn", "en".

postalCode

string

Opcional. Código postal de la dirección. No todos los países usan o exigen la presencia de códigos postales, pero en los lugares donde se usan, es posible que activen una validación adicional con otras partes de la dirección (p. ej., validación del código postal o el estado en EE.UU.).

sortingCode

string

Opcional. Código de ordenamiento adicional específico para cada país. No se usa en la mayoría de las regiones. Cuando se utiliza, el valor es una cadena como &CEDEX; opcionalmente seguida por un número (p. ej. "CEDEX 7), o solo un número, que representa el "código de la sección" (Jamaica), el indicador de área de entrega (Malawi) o el indicador de oficina de correos.

administrativeArea

string

Opcional. División administrativa más alta que se usa para las direcciones postales de un país o una región. Por ejemplo, puede ser un estado, una provincia, una óblast o una prefectura. En el caso específico de España, corresponde a la provincia y no a la comunidad autónoma (p.ej., "Barcelona" y no "Cataluña"). Muchos países no usan un área administrativa en las direcciones postales. P. ej., en Suiza se dejaría vacío.

locality

string

Opcional. Por lo general, se refiere a la parte de la dirección que indica la ciudad o el pueblo. Ejemplos: ciudad de EE.UU., comuna de Italia o ciudad postal en el Reino Unido. En regiones del mundo donde las localidades no están bien definidas o no coinciden bien con esta estructura, deja la localidad vacía y usa addressLines.

sublocality

string

Opcional. Sublocalidad de la dirección. Por ejemplo, pueden ser barrios, vecindarios o distritos.

addressLines[]

string

Líneas de dirección no estructuradas que describen los niveles más bajos de una dirección.

Debido a que los valores en addressLines no tienen información de tipo y a veces pueden contener múltiples valores en un solo campo (p.ej., "Austin, TX", es importante que el orden de las líneas sea claro). El orden de las líneas de dirección debe ser el "orden de sobre" que se usa en el país o la región de la dirección. En lugares donde esto puede variar, (p. ej., Japón), address_language se usa para hacerlo explícito (p. ej., "ja" para ordenar de mayor a menor en "ja-Latn" o "en" para indicar de menor a mayor). De esta manera, se puede seleccionar la línea más específica de una dirección a partir del idioma.

La representación estructural mínima que se permite para una dirección consiste en un regionCode con toda la información restante incluida en addressLines. Sería posible dar un formato a una dirección así de manera muy aproximada sin codificación geográfica, pero no podría realizarse un análisis semántico de ningún componente de la dirección hasta que se resuelva, al menos, de manera parcial.

Crear una dirección que solo contiene regionCode y addressLines, y luego realizar la codificación geográfica es la manera recomendada de controlar direcciones sin estructura alguna (en lugar de inferir qué partes de la dirección deben ser localidades o áreas administrativas).

recipients[]

string

Opcional. El destinatario en la dirección. Es posible que este campo contenga varias líneas de información en ciertas circunstancias. Por ejemplo, puede contener información sobre la entrega "por medio de".

organization

string

Opcional. El nombre de la organización de la dirección.

Métodos

create

Crea una cuenta con el nombre y el tipo especificados debajo del superior.

get

Obtiene la cuenta especificada.

list

Muestra una lista de todas las cuentas del usuario autenticado.

patch

Actualiza la cuenta comercial especificada.