L'API
Google Business Performance ha un metodo
NOVITÀ che consente di recuperare più `dailyMetrics` in un'unica richiesta API.
Consulta il
calendario del ritiro e le istruzioni per eseguire la migrazione dal metodo API ReportInsights della versione 4 all'API Performance di Google Profilo.
Method: accounts.invitations.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Elenca gli inviti in attesa per l'account specificato.
Richiesta HTTP
GET https://mybusiness.googleapis.com/v4/{parent=accounts/*}/invitations
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri |
parent |
string
Il nome dell'account da cui viene recuperato l'elenco degli inviti.
|
Parametri di query
Parametri |
targetType |
enum (TargetType )
Specifica i tipi di target che devono essere visualizzati nella risposta.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Messaggio di risposta per AccessControl.ListInvites.
Rappresentazione JSON |
{
"invitations": [
{
object (Invitation )
}
]
} |
Campi |
invitations[] |
object (Invitation )
Una raccolta di inviti alla posizione in attesa per l'account. Il numero di inviti qui elencato non può essere superiore a 1000.
|
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
TargetType
Il tipo di target a cui è rivolto un invito.
Enum |
ALL |
Elenca gli inviti per tutti i tipi di target. Questa è l'impostazione predefinita. |
ACCOUNTS_ONLY |
Elenca gli inviti solo per i target di tipo Account. |
LOCATIONS_ONLY |
Elenca gli inviti solo per i target di tipo Località. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eThis endpoint retrieves pending invitations for a specified Google My Business account.\u003c/p\u003e\n"],["\u003cp\u003eIt allows filtering by target type (Account or Location) using the \u003ccode\u003etargetType\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of invitations with details, limited to a maximum of 1000.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using specific OAuth scopes related to business management.\u003c/p\u003e\n"],["\u003cp\u003eThis endpoint is deprecated; consider using the Account Management API instead.\u003c/p\u003e\n"]]],["This document outlines the process of listing pending invitations for a specified account using the deprecated API. It uses a `GET` request to `https://mybusiness.googleapis.com/v4/{parent=accounts/*}/invitations`. The `parent` path parameter specifies the account. The `targetType` query parameter filters invitation types. An empty request body is required. The response returns a JSON array of `invitations`, each represented as an object. The request needs either the `plus.business.manage` or `business.manage` authorization scope. Three types are available: ALL, ACCOUNTS_ONLY and LOCATIONS_ONLY.\n"],null,["# Method: accounts.invitations.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListInvitationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n- [TargetType](#TargetType)\n\n| Deprecated. Please use the [Account Management API](https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.invitations/list) instead.\nLists pending invitations for the specified account.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{parent=accounts/*}/invitations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------|\n| `parent` | `string` The name of the account from which the list of invitations is being retrieved. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `targetType` | `enum (`[TargetType](/my-business/reference/rest/v4/accounts.invitations/list#TargetType)`)` Specifies which target types should appear in the response. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message for AccessControl.ListInvitations.\n\n| JSON representation ||\n|------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"invitations\": [ { object (/my-business/reference/rest/v4/accounts.invitations#Invitation) } ] } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `invitations[]` | `object (`[Invitation](/my-business/reference/rest/v4/accounts.invitations#Invitation)`)` A collection of location invitations that are pending for the account. The number of invitations listed here cannot exceed 1000. |\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/plus.business.manage`\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nTargetType\n----------\n\nThe type of target an invitation is for.\n\n| Enums ||\n|------------------|-------------------------------------------------------------|\n| `ALL` | List invitations for all target types. This is the default. |\n| `ACCOUNTS_ONLY` | List invitations only for targets of type Account. |\n| `LOCATIONS_ONLY` | List invitations only for targets of type Location. |"]]