CSS API を使ってみる

CSS API の使用方法は次のとおりです。

権限

CSS API を使用するには、Google Cloud と CSS Center の 2 か所で権限を構成する必要があります。

  1. Google Cloud IAM:

    • Google Cloud コンソールでサービス アカウントを作成します。Content API の場合と同様の手順に沿って、JSON 認証情報ファイルを作成してダウンロードします。このステップでは、サービス アカウントを有効な Google Cloud エンティティとして認証します。
    • 直接 REST アクセスまたは Google API クライアント ライブラリを使用している場合は、Google Cloud コンソールで生成された API キーも必要です。

  2. CSS Center:

    • サービス アカウントのメールアドレス（例:your-service-account-name@your-project-id.iam.gserviceaccount.com）は、CSS Center アカウントに管理者権限を持つユーザーとして追加する必要があります。この手順では、サービス アカウントに CSS Center のデータへのアクセスと管理を許可します。
    • アクセス権は、CSS グループ レベル（すべてのドメインへのアクセス）または特定の CSS ドメイン アカウントに付与できます。API アクセスの場合、CSS グループ レベルでアクセス権を付与するのが一般的です。
    • サービス アカウントを追加するには:
      • 管理者ユーザーで CSS Center にログインします。
      • [アカウントのアクセス権]（歯車アイコン ⚙️ の下）に移動します。
      • [+ ユーザーを追加] をクリックし、サービス アカウントのメールアドレスを入力します。
      • アクセスレベルを [管理者] に設定します。
    • 権限が反映されるまでに 30 分ほどかかることがあります。権限エラーが発生した場合は、しばらくしてからもう一度お試しください。

認証スコープ:

CSS API に必要な OAuth 2.0 スコープは次のとおりです。

  • https://www.googleapis.com/auth/content

認証時にアプリケーションがこのスコープをリクエストしていることを確認します。

CSS API を有効にする

CSS API を使用するには、Google Cloud プロジェクトで CSS API を有効にする必要があります。ライブラリは https://console.cloud.google.com/apis/library/css.googleapis.com で確認できます。

プログラミングを開始する

CSS API には、コードサンプルとクライアント ライブラリが用意されており、これらを利用して簡単に始めることができます。ベスト プラクティスのページもあります。

リクエストの送信

次の形式の URL にリクエストを送信します。

https://css.googleapis.com/{version}/{resource name}:{method}…

ここで、{resource name} は呼び出しが影響するリソースの名前です。

たとえば、gRPC を使用してリソースを削除する方法は次のとおりです。

https://css.googleapis.com/v1/{resource name}:delete

REST を使用してリソースを削除する方法は次のとおりです。

DELETE https://css.googleapis.com/v1/{resource name}

特定のサービスの詳細については、CSS API のリファレンス ドキュメントをご覧ください。

gRPC または REST を使用する

CSS API は gRPC と REST をサポートしています。CSS API 呼び出しを行う方法は次の 2 つです。

gRPC（推奨） REST
  1. リクエストの本文をプロトコル バッファとして作成します。
  2. HTTP/2 でリクエスト本文をサーバーに送信します。
  3. レスポンスをプロトコル バッファにシリアル化解除します。
  4. 結果を解釈します。
  1. リクエストの本文を JSON オブジェクトとして作成します。
  2. HTTP 1.1 を使用してサーバーに送信します。
  3. レスポンスを JSON オブジェクトとして逆シリアル化します。
  4. 結果を解釈する。

ヘルプ

サポートについては Google の担当者にお問い合わせいただくか、フィードバック フォームを使用して問題を報告してください。

問題が発生した場合は、次の方法で詳細なフィードバックをお送りいただけます。

フィードバックを送信

フィードバックを送信するには、次のいずれかを送信します。

  • API の機能: フィードバック フォームを送信する
  • ドキュメント: ページ内の高評価 / 低評価と [フィードバックを送信] ボタンを使用します。
  • サンプルとライブラリ: GitHub の [新しい問題] ボタンを使用します。

各タスクを実装した後に一般的なフィードバックを送信するには、フィードバック フォームを使用します。

前へ
概要
次へ
ベスト プラクティス