Google Business Performance API memiliki metode API
BARU yang memungkinkan pengambilan beberapa `DailyMetrics` dalam satu permintaan API.
Tinjau
jadwal penghentian dan petunjuk untuk bermigrasi dari metode API reportInsights v4 ke Google Business Profile Performance API.
Method: accounts.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mencantumkan semua akun untuk pengguna terautentikasi. Hal ini mencakup semua akun yang dimiliki pengguna, serta akun apa pun yang hak pengelolaannya dimiliki pengguna.
Permintaan HTTP
GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
| Parameter |
parentAccount |
string
Opsional. Nama resource akun tempat daftar akun yang dapat diakses secara langsung akan diambil. Hal ini hanya berlaku untuk Organisasi dan Grup Pengguna. Jika kosong, accounts.list akan ditampilkan untuk pengguna terautentikasi. accounts/{account_id}.
|
pageSize |
integer
Opsional. Berapa banyak akun yang akan diambil per halaman. Nilai default dan maksimumnya adalah 20.
|
pageToken |
string
Opsional. Jika ditentukan, halaman akun berikutnya akan diambil. pageToken ditampilkan saat panggilan ke accounts.list menampilkan lebih banyak hasil daripada yang bisa sesuai dengan ukuran halaman yang diminta.
|
filter |
string
Opsional. Filter yang membatasi akun yang akan ditampilkan. Respons hanya menyertakan entri yang cocok dengan filter. Jika filter kosong, tidak ada batasan yang diterapkan dan semua akun (bernomor halaman) diambil untuk akun yang diminta. Misalnya, permintaan dengan filter type=USER_GROUP hanya akan menampilkan grup pengguna. Kolom type adalah satu-satunya filter yang didukung.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Pesan respons untuk Accounts.ListAccounts.
Jika berhasil, isi respons memuat data dengan struktur berikut:
| Representasi JSON |
{
"accounts": [
{
object (Account)
}
],
"nextPageToken": string
} |
| Kolom |
accounts[] |
object (Account)
Kumpulan akun yang dapat diakses oleh pengguna. Akun pribadi pengguna yang melakukan kueri akan selalu menjadi item pertama dari hasil, kecuali jika difilter.
|
nextPageToken |
string
Jika jumlah akun melebihi ukuran halaman yang diminta, kolom ini diisi dengan token untuk mengambil halaman akun berikutnya pada panggilan berikutnya ke accounts.list. Jika tidak ada lagi akun, kolom ini tidak ada dalam respons.
|
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/business.manage
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 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)."]]
