La API de
Google Business Performance tiene un método de API
NUEVO que permite recuperar varias métricas "DailyMetrics" en una sola solicitud a la API.
Revise el
programa de baja y las instrucciones para migrar del método de la API de reportInsights versión 4 a la API de rendimiento del Perfil de Negocio de Google.
Cómo trabajar con los datos de la cuenta
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En este instructivo, se muestra cómo trabajar con los datos de la cuenta. La API de My Business Account Management te permite hacer lo siguiente:
- Muestra una lista de todas las cuentas.
- Devuelve una cuenta específica.
- Actualizar una cuenta
Antes de comenzar
Antes de usar la API de Mi Negocio Account Management, debes registrar tu aplicación y obtener credenciales de OAuth 2.0.
Para obtener detalles sobre cómo comenzar a usar las APIs de Perfil de Negocio, consulta Configuración básica.
Cómo mostrar todas las cuentas
Una excelente manera de validar las cuentas asociadas con un usuario autenticado es enumerar todas sus cuentas. Usa la API de accounts.list
para enumerar todas las cuentas asociadas con un usuario.
Para enumerar todas las cuentas de un usuario autenticado, usa lo siguiente:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Cómo mostrar una cuenta específica
A veces, solo quieres ver información sobre una cuenta específica de un usuario
autorizado. Usa la API de accounts.get
para mostrar una cuenta específica y revisar detalles adicionales.
Para mostrar una cuenta específica por nombre, usa lo siguiente:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}
Cómo actualizar una cuenta
Cambiar el nombre de una cuenta es una tarea administrativa fundamental. Usa la API de accounts.update
para alterar el nombre de la cuenta.
Para actualizar una cuenta específica por nombre, usa lo siguiente:
$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}
{
"account": {
"accountName": "Anne Droyd"
},
"languageCode": "en",
"validateOnly": "true"
}
Restricciones
- El único campo editable de una cuenta es
accountName
. Se ignoran todos los demás campos que se pasen.
- Solo se pueden actualizar de esta manera las cuentas de tipo
BUSINESS
.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-29 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-29 (UTC)"],[[["\u003cp\u003eThe My Business Account Management API allows you to manage business accounts, including listing all accounts, retrieving specific account details, and updating account names.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, you must register your application and obtain OAuth 2.0 credentials as outlined in the basic setup guide.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve a list of all accounts associated with an authenticated user or fetch details for a specific account using dedicated API endpoints.\u003c/p\u003e\n"],["\u003cp\u003eUpdating an account is restricted to changing the account name for business type accounts only, with other fields being ignored.\u003c/p\u003e\n"]]],[],null,["# Work with account data\n\n\u003cbr /\u003e\n\nThis tutorial shows you how to work with account data. The My Business Account Management API\nprovides you with the ability to do the following:\n\n- List all accounts.\n- Return a specific account.\n- Update an account.\n\nBefore you begin\n----------------\n\nBefore you use the My Business Account Management API, you need to register your application\nand obtain OAuth 2.0 credentials.\n\nFor details on how to get started with the Business Profile APIs, see\n[Basic setup](/my-business/content/basic-setup).\n\nList all accounts\n-----------------\n\nA great way to validate the accounts associated with an authenticated user is to\nlist all their accounts. Use the [`accounts.list`](/my-business/reference/accountmanagement/rest/v1/accounts/list)\nAPI to list all accounts associated with a user.\n\nTo list all the accounts for an authenticated user, use the following:\nHTTP \n\n```bash\n$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts\n```\n\nReturn a specific account\n-------------------------\n\nSometimes, you only want to see information about a specific account for an\nauthenticated user. Use the [`accounts.get`](/my-business/reference/accountmanagement/rest/v1/accounts/get)\nAPI to return a specific account and review additional account details.\n\nTo return a specific account by name, use the following:\nHTTP \n\n```bash\n$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}\n```\n\nUpdate an account\n-----------------\n\nChanging an account name is a fundamental administrative task. Use the\n[`accounts.update`](/my-business/reference/accountmanagement/rest/v1/accounts/patch) API to alter\nthe account name.\n\nTo update a specific account by name, use the following:\nHTTP \n\n```bash\n$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}\n\n{\n \"account\": {\n \"accountName\": \"Anne Droyd\"\n },\n \"languageCode\": \"en\",\n \"validateOnly\": \"true\"\n}\n```\n\n### Restrictions\n\n- The only editable field for an account is `accountName`. Any other fields passed are ignored.\n- Only accounts of `BUSINESS` type can be updated in this manner."]]