La API
Performance de Perfil de Empresa en Google tiene un
NUEVO método que permite obtener varios valores del parámetro "DailyMetrics" con una misma solicitud.
Consulta el
calendario de desactivación y las instrucciones para pasar del método reportInsights de la versión 4 de la API de Google My Business a la API Performance de Perfil de Empresa en Google.
Trabajar con datos de la cuenta
Organízate con las colecciones
Guarda y clasifica el contenido según tus preferencias.
En este tutorial se explica cómo utilizar datos de cuentas. La API My Business Account Management te permite hacer lo siguiente:
- Obtener una lista con todas las cuentas
- Hacer una consulta que devuelva una cuenta específica
- Actualizar una cuenta
Antes de empezar
Para usar la API My Business Account Management, necesitas registrar tu aplicación y obtener credenciales de OAuth 2.0.
Para saber cómo empezar a usar las APIs de Perfil de Empresa, consulta el artículo Configuración básica.
Obtener una lista con todas las cuentas
Una forma eficaz de validar las cuentas asociadas a un usuario autenticado es obtener una lista con todas sus cuentas. Obtenla mediante la API accounts.list.
Para obtener una lista con todas las cuentas de un usuario autenticado, utiliza el código siguiente:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Devolver una cuenta específica
Hay situaciones en las que solo quieres ver información sobre una cuenta específica de un
usuario autenticado. Utiliza la API accounts.get para que devuelva una cuenta específica y puedas consultar detalles adicionales de dicha cuenta.
Para consultar una cuenta específica por nombre, utiliza el código siguiente:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}
Actualizar una cuenta
Cambiar nombres de cuentas es una tarea básica de gestión. Para hacerlo, usa la API accounts.update.
Para actualizar una cuenta específica por nombre, utiliza el código siguiente:
$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}
{
"account": {
"accountName": "Anne Droyd"
},
"languageCode": "en",
"validateOnly": "true"
}
Restricciones
- El único campo cuyo valor se puede editar en una cuenta es
accountName. Si se envían valores de otros campos, se ignorarán.
- Las únicas cuentas que se pueden actualizar de esta manera son las de tipo
BUSINESS.
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-11-27 (UTC).
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Me falta la información que necesito","missingTheInformationINeed","thumb-down"],["Es demasiado complicado o hay demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Está obsoleto","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema de muestras o código","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2024-11-27 (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."]]