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://mybusiness.googleapis.com/v4/accounts
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
| Parametreler |
pageSize |
integer
Sayfa başına getirilecek hesap sayısı. Varsayılan değer 20, minimum değer 2 ve maksimum sayfa boyutu 20'dir.
|
pageToken |
string
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.
|
name |
string
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.
|
filter |
string
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.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
Accounts.ListAccounts için yanıt iletisi.
| 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 kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/plus.business.managehttps://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\u003eThis API endpoint, now deprecated, was used to retrieve a list of Google My Business accounts for the authenticated user, including owned and managed accounts.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes account details and a pagination token for retrieving additional results.\u003c/p\u003e\n"],["\u003cp\u003eFiltering options were available to narrow down the returned accounts based on criteria like account type.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization required either \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUsers should now utilize the Account Management API for similar functionality.\u003c/p\u003e\n"]]],["This document outlines how to retrieve a list of accounts for an authenticated user via a `GET` request to `https://mybusiness.googleapis.com/v4/accounts`. The request can utilize query parameters like `pageSize`, `pageToken`, `name`, and `filter` to control the results. The request body must be empty. A successful response includes an array of `accounts` and optionally a `nextPageToken` for pagination. Authorization requires specific OAuth scopes.\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\n| Deprecated. Please use the [Account Management API](https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts/list) instead.\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://mybusiness.googleapis.com/v4/accounts`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` How many accounts to fetch per page. Default is 20, minimum is 2, and maximum page size is 20. |\n| `pageToken` | `string` 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| `name` | `string` 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. |\n| `filter` | `string` 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. |\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 Accounts.ListAccounts.\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"accounts\": [ { object (/my-business/reference/rest/v4/accounts#Account) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `accounts[]` | `object (`[Account](/my-business/reference/rest/v4/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 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)."]]
