---
title: connections
description: Search Console のプロパティと検索パフォーマンスを取得します。
canonical_url: https://orchestor.io/docs/cli/search-console
markdown_url: https://orchestor.io/docs/cli/search-console.md
contentType: reference
---

# connections

`orc connections` のSearch Console操作は、接続したGoogleアカウントでアクセス可能なプロパティを一覧し、選択したプロパティの検索パフォーマンス、URLのインデックス状態、送信済みサイトマップを取得します。検索語句・ページ・国・デバイスなどの条件でデータを絞り込めます。

プロパティの選択はOrchestorの接続に保存します。Google側の設定やサイトマップは変更しません。最初に接続IDを確認し、取得対象のプロパティを選択してください。

## 使い方

```bash title="terminal"
orc connections list --workspace YOUR_WORKSPACE_ID --provider google-search-console --format json
```

*使用例*

## サブコマンド

### `search-console-sites-list`

アクセスできるプロパティを一覧表示

```bash title="terminal"
orc connections search-console-sites-list <id> [options]
```

### `search-console-site-select`

接続で使用するプロパティを選択

```bash title="terminal"
orc connections search-console-site-select <id> [options]
```

#### 固有のオプション

##### `--site-url`

(required) Body field: site_url; max 2048 chars

型: `string`。任意。

```bash title="terminal"
orc connections search-console-site-select <id> --site-url <value>
```

### `search-console-analytics-query`

検索パフォーマンスを取得

```bash title="terminal"
orc connections search-console-analytics-query <id> [options]
```

#### 固有のオプション

##### `--aggregation-type`

Body field: aggregation_type; enum: auto|byPage|byProperty|byNewsShowcasePanel

型: `string`。任意。

```bash title="terminal"
orc connections search-console-analytics-query <id> --aggregation-type <value>
```

##### `--data-state`

Body field: data_state; enum: final|all|hourly_all

型: `string`。任意。

```bash title="terminal"
orc connections search-console-analytics-query <id> --data-state <value>
```

##### `--dimension-filter-groups`

Body field: dimension_filter_groups; JSON array of objects (use --stdin for large resources)

型: `string`。任意。

```bash title="terminal"
orc connections search-console-analytics-query <id> --dimension-filter-groups <value>
```

##### `--dimensions`

Body field: dimensions; csv of: date|query|page|country|device|searchAppearance|hour

型: `string`。任意。

```bash title="terminal"
orc connections search-console-analytics-query <id> --dimensions <value>
```

##### `--end-date`

(required) Inclusive date in America/Los_Angeles (Pacific Time).

型: `string`。任意。

```bash title="terminal"
orc connections search-console-analytics-query <id> --end-date <value>
```

##### `--row-limit`

Body field: row_limit

型: `number`。任意。

```bash title="terminal"
orc connections search-console-analytics-query <id> --row-limit <value>
```

##### `--start-date`

(required) Inclusive date in America/Los_Angeles (Pacific Time).

型: `string`。任意。

```bash title="terminal"
orc connections search-console-analytics-query <id> --start-date <value>
```

##### `--start-row`

Body field: start_row

型: `number`。任意。

```bash title="terminal"
orc connections search-console-analytics-query <id> --start-row <value>
```

##### `--type`

Body field: type; enum: web|image|video|news|discover|googleNews

型: `string`。任意。

```bash title="terminal"
orc connections search-console-analytics-query <id> --type <value>
```

### `search-console-url-inspect`

URL のインデックス状態を取得

```bash title="terminal"
orc connections search-console-url-inspect <id> [options]
```

#### 固有のオプション

##### `--inspection-url`

(required) Body field: inspection_url; max 2048 chars

型: `string`。任意。

```bash title="terminal"
orc connections search-console-url-inspect <id> --inspection-url <value>
```

##### `--language-code`

BCP-47 language code, for example en-US.; max 35 chars

型: `string`。任意。

```bash title="terminal"
orc connections search-console-url-inspect <id> --language-code <value>
```

### `search-console-sitemaps-list`

送信済みサイトマップを取得

```bash title="terminal"
orc connections search-console-sitemaps-list <id> [options]
```

## 使用例

### 使用例

```bash title="terminal"
orc connections search-console-sites-list YOUR_CONNECTION_ID --workspace YOUR_WORKSPACE_ID --format json
orc connections search-console-site-select YOUR_CONNECTION_ID --workspace YOUR_WORKSPACE_ID --site-url 'sc-domain:example.com' --format json
```

*使用例*

### 使用例

```bash title="terminal"
orc connections search-console-analytics-query YOUR_CONNECTION_ID --workspace YOUR_WORKSPACE_ID --start-date 2026-09-01 --end-date 2026-09-30 --dimensions query,page --row-limit 1000 --format json
```

*使用例*

### 使用例

以下の JSON を analytics.json に保存します。

```bash title="terminal"
orc connections search-console-analytics-query YOUR_CONNECTION_ID --workspace YOUR_WORKSPACE_ID --stdin --format json < analytics.json
```

*使用例*

```json title="analytics.json"
{
  "start_date": "2026-09-01",
  "end_date": "2026-09-30",
  "dimensions": [
    "page"
  ],
  "dimension_filter_groups": [
    {
      "filters": [
        {
          "dimension": "page",
          "operator": "contains",
          "expression": "/blog/"
        }
      ]
    }
  ]
}
```

### 使用例

```bash title="terminal"
orc connections search-console-url-inspect YOUR_CONNECTION_ID --workspace YOUR_WORKSPACE_ID --inspection-url 'https://example.com/page' --language-code ja-JP --format json
```

*使用例*

### 使用例

```bash title="terminal"
orc connections search-console-sitemaps-list YOUR_CONNECTION_ID --workspace YOUR_WORKSPACE_ID --format json
```

*使用例*

## 必要な権限

対象プロパティを読める Google アカウントを接続し、`webmasters.readonly` スコープで認可します。Orchestor ではログインとアクセス可能な Workspace が必要です。

## グローバルオプション

`orc connections` では、次の[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を使用できます。

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%98%E3%83%AB%E3%83%97)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AF%E3%83%BC%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#%E5%87%BA%E5%8A%9B%E5%BD%A2%E5%BC%8F)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#%E5%80%A4%E3%81%A0%E3%81%91%E3%82%92%E5%87%BA%E5%8A%9B)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%B8%E3%81%AE%E5%87%BA%E5%8A%9B)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%9A%E3%83%BC%E3%82%B8%E9%80%81%E3%82%8A)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%AE%E4%BA%8B%E5%89%8D%E7%A2%BA%E8%AA%8D)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#%E7%A2%BA%E8%AA%8D%E3%81%AE%E7%9C%81%E7%95%A5)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#%E3%81%99%E3%81%B9%E3%81%A6%E3%81%AE%E3%83%9A%E3%83%BC%E3%82%B8%E3%82%92%E5%8F%96%E5%BE%97)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E6%99%82%E9%96%93)

各オプションの詳細と使用例は、[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を参照してください。

---

[Documentation index](https://orchestor.io/docs/llms.txt)