> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Accounts

> キャンペーンを作成できる Google Ads アカウントを一覧表示し、Google が開けない連携済みアカウントとその理由を確認します。

キャンペーンを作成できる Google Ads アカウントを取得します。キャンペーンを作成するときは、アカウントの `id` を `accountId` として使用してください。

<ul>
  <li>まず "Social Accounts" ページから Google Ads を連携してください。</li>
  <li>連携する Google ユーザーは、広告アカウントに直接アクセスできる必要があります。マネージャー アカウント経由でのみアクセスできるアカウントは一覧に表示されず、現時点では使用できません。そのユーザーを広告アカウント自体に追加してください。マネージャー アカウントも一覧に表示されません。マネージャー アカウントはキャンペーンを保持できないためです。</li>
  <li>すべてのアカウントが1つのレスポンスで返されるため、`nextCursor` は常に `null` です。</li>
</ul>

## ヘッダーパラメータ

**Authorization** `string` *required*

[API Key](https://www.ayrshare.com/docs/apis/overview.md#authorization) of the Primary Profile.

Format: `Authorization: Bearer API_KEY`
**Profile-Key** `string`

[Profile Key](https://www.ayrshare.com/docs/apis/overview.md#profile-key-format) of a User Profile.

Format: `Profile-Key: PROFILE_KEY`

## レスポンス

`adAccounts` には使用できるアカウントが一覧表示されます。各アカウントには `id`、`name`、`currency` が含まれます。

Google がアカウントを一覧に表示しているものの開けない場合、レスポンスには `unavailableAccounts` も含まれます。各エントリにはアカウントの `id` と `reason` が含まれます。すべてのアカウントが使用できる場合、このフィールドはありません。

| `reason` | 意味 | 対処方法 |
| - | - | - |
| `notEnabled` | アカウントが解約済み、停止中、またはまだ設定されていません。 | Google Ads でセットアップを完了するか、アカウントを再有効化してから、もう一度アカウントを一覧表示してください。変更が反映されるまで最大10分ほどかかる場合があります。 |
| `noAccess` | 連携した Google ユーザーはアカウントを表示できますが、そのデータにアクセスする権限がありません。 | Google Ads でそのユーザーに広告アカウントへのアクセス権を付与してから、もう一度アカウントを一覧表示してください。変更が反映されるまで最大10分ほどかかる場合があります。 |

```bash cURL theme={"system"}
curl \
-H "Authorization: Bearer API_KEY" \
-X GET "https://api.ayrshare.com/api/ads/google/accounts"
```

```javascript JavaScript theme={"system"}
const API_KEY = "API_KEY";

fetch("https://api.ayrshare.com/api/ads/google/accounts", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${API_KEY}`
  }
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);
```

```python Python theme={"system"}
import requests

headers = {
    "Authorization": "Bearer API_KEY",
}

r = requests.get("https://api.ayrshare.com/api/ads/google/accounts", headers=headers)

print(r.json())
```

```php PHP theme={"system"}
<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.ayrshare.com/api/ads/google/accounts",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer API_KEY"
    ]
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
    echo "cURL Error: " . $err;
} else {
    echo $response;
}
?>
```

```csharp C# theme={"system"}
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer API_KEY");

        var response = await client.GetAsync("https://api.ayrshare.com/api/ads/google/accounts");
        var content = await response.Content.ReadAsStringAsync();

        Console.WriteLine(content);
    }
}
```

```go Go theme={"system"}
package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.ayrshare.com/api/ads/google/accounts", nil)
    req.Header.Add("Authorization", "Bearer API_KEY")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}
```

```java Java theme={"system"}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class GetAdAccounts {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.ayrshare.com/api/ads/google/accounts"))
            .header("Authorization", "Bearer API_KEY")
            .GET()
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}
```

```ruby Ruby theme={"system"}
require 'net/http'
require 'uri'

uri = URI.parse('https://api.ayrshare.com/api/ads/google/accounts')

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer API_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.body
```

```json 200: Success theme={"system"}
{
  "status": "success",
  "adAccounts": [{ "id": "1234567890", "name": "Acme", "currency": "USD" }],
  "nextCursor": null,
  "unavailableAccounts": [{ "id": "2345678901", "reason": "notEnabled" }]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.