Google Business Performance API, tek bir API isteğinde birden fazla "GünlükMetrik" getirmeye olanak tanıyan
YENİ bir API yöntemine sahiptir.
Kullanımdan kaldırma planını ve v4 reportInsights API yönteminden Google Business Profile Performance API'ye geçiş talimatlarını inceleyin.
Method: accounts.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kimliği doğrulanmış kullanıcının tüm hesaplarını listeler. Kullanıcının sahip olduğu tüm hesapların yanı sıra kullanıcının yönetim haklarına sahip olduğu tüm hesaplar da buna dahildir.
HTTP isteği
GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
| Parametreler |
parentAccount |
string
İsteğe bağlı. Doğrudan erişilebilen hesaplar listesinin alınacağı hesabın kaynak adı. Bu, yalnızca Kuruluşlar ve Kullanıcı Grupları için anlamlıdır. Boşsa, kimliği doğrulanmış kullanıcı için accounts.list değerini döndürür. accounts/{account_id}.
|
pageSize |
integer
İsteğe bağlı. Sayfa başına getirilecek hesap sayısı. Varsayılan değer ve maksimum değer 20'dir.
|
pageToken |
string
İsteğe bağlı. Belirtilirse hesapların sonraki sayfası alınır. accounts.list için yapılan bir çağrı, istenen sayfa boyutuna sığmayacak kadar fazla sonuç döndürdüğünde, pageToken döndürülür.
|
filter |
string
İsteğe bağlı. Hesapları döndürülecek şekilde kısıtlayan bir filtre. Yanıt yalnızca filtreyle eşleşen girişleri içerir. filter boşsa hiçbir kısıtlama uygulanmaz ve istenen hesap için tüm hesaplar (sayfalara ayrılmış) alınır. Örneğin, type=USER_GROUP filtresini içeren bir istek yalnızca kullanıcı gruplarını döndürür. type alanı desteklenen tek filtredir.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Accounts.ListAccounts için yanıt iletisi.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
{
"accounts": [
{
object (Account)
}
],
"nextPageToken": string
} |
| Alanlar |
accounts[] |
object (Account)
Kullanıcının erişebildiği hesaplar koleksiyonu. Sorguyu yapan kullanıcının kişisel hesabı, filtrelenmemişse her zaman sonucun ilk öğesi olur.
|
nextPageToken |
string
Hesap sayısı istenen sayfa boyutunu aşıyorsa bu alan, bir sonraki accounts.list çağrısında hesapların sonraki sayfasını getirmek için bir jetonla doldurulur. Başka hesap yoksa bu alan yanıtta bulunmaz.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/business.manage
Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[[["\u003cp\u003eLists all accounts owned by or accessible to the authenticated user, including their personal account.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering accounts by type and specifying the parent account for retrieval.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large lists of accounts using \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of \u003ccode\u003eAccount\u003c/code\u003e objects and a \u003ccode\u003enextPageToken\u003c/code\u003e for further results.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This API retrieves a list of accounts for an authenticated user via a `GET` request to a specified URL. The user can filter the accounts by type, specify the page size, and use a `pageToken` for pagination. An optional `parentAccount` parameter retrieves accounts directly accessible from that account. The request body must be empty, and the successful response includes an array of account objects and, if applicable, a `nextPageToken` for further pagination. This uses OAuth 2.0 with the `business.manage` scope.\n"],null,["# Method: accounts.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListAccountsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nLists all of the accounts for the authenticated user. This includes all accounts that the user owns, as well as any accounts for which the user has management rights.\n\n### HTTP request\n\n`GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parentAccount` | `string` Optional. The resource name of the account for which the list of directly accessible accounts is to be retrieved. This only makes sense for Organizations and User Groups. If empty, will return `accounts.list` for the authenticated user. `accounts/{account_id}`. |\n| `pageSize` | `integer` Optional. How many accounts to fetch per page. The default and maximum is 20. |\n| `pageToken` | `string` Optional. If specified, the next page of accounts is retrieved. The `pageToken` is returned when a call to `accounts.list` returns more results than can fit into the requested page size. |\n| `filter` | `string` Optional. A filter constraining the accounts to return. The response includes only entries that match the filter. If `filter` is empty, then no constraints are applied and all accounts (paginated) are retrieved for the requested account. For example, a request with the filter `type=USER_GROUP` will only return user groups. The `type` field is the only supported filter. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for Accounts.ListAccounts.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"accounts\": [ { object (/my-business/reference/accountmanagement/rest/v1/accounts#Account) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `accounts[]` | `object (`[Account](/my-business/reference/accountmanagement/rest/v1/accounts#Account)`)` A collection of accounts to which the user has access. The personal account of the user doing the query will always be the first item of the result, unless it is filtered out. |\n| `nextPageToken` | `string` If the number of accounts exceeds the requested page size, this field is populated with a token to fetch the next page of accounts on a subsequent call to `accounts.list`. If there are no more accounts, this field is not present in the response. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\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)."]]
