Enterprise License Manager API: デベロッパー ガイド

このドキュメントでは、アカウント レベルの管理者と販売パートナーの管理者が Enterprise License Manager API を使用してユーザーのライセンス割り当てを管理する方法について説明します。アカウントのサービス SKU ライセンスを有効にしてユーザーを作成したら、Enterprise License Manager API を使用して、アカウントのユーザーのライセンスの割り当て、更新、取得、削除を行います。

このバージョンでは、Enterprise License Manager API はアカウント管理者と販売パートナー管理者によって使用されます。代理 License Management 権限を持つ管理者は、Enterprise License Manager API も使用できます。

注: Enterprise License Manager API は Google のお客様が使用します。Google のサードパーティ製アプリのデベロッパーがライセンスを管理する方法について詳しくは、Google Workspace Marketplace API をご覧ください。

Enterprise License Manager API は、ウェブサービスに対する Representational State Transfer(RESTful)設計アプローチに基づいています。

ライセンスの管理

ライセンスを割り当てる

この操作の前に、お客様または販売パートナーは Google サービス ライセンスを注文し、ユーザーを作成していました。これらのサービス ライセンスのいずれかをこのユーザーに割り当てるには、次の POST HTTP リクエストを使用します。リクエストの承認で説明されているように、Authorization ヘッダーを含めます。サービス ID と SKU ID については、API で利用可能なサービスと SKU をご覧ください。

POST https://www.googleapis.com/apps/licensing/v1/product/productId/sku/skuId/user

注: ユーザーには、さまざまな Google サービスのライセンスを割り当てることができます。1 人のユーザーに一度に割り当てられる SKU ライセンスは 1 つのみです。API を使用すると、ユーザーの SKU ライセンスをサービス内の別の SKU ライセンスに再割り当てできます。

この例では、メインのメールアドレスが alex@example.com のユーザーに Google-Drive-storage-20GB SKU を割り当てます。

POST https://www.googleapis.com/apps/licensing/v1/product/Google-Drive-storage/sku/Google-Drive-storage-20GB/user

JSON リクエスト本文:

{
  "userId" : "alex@example.com",
}

成功すると、200 HTTP ステータス コードが返されます。考えられるエラーコードについては、API のエラーコードをご覧ください。成功すると、ライセンス割り当てのステータスが JSON データ形式で返されます。

JSON レスポンス

{
  "kind": "licensing#licenseAssignment",
  "etags": "etag value",
  "selfLink": "https://www.googleapis.com/apps/licensing/v1/product/Google-Drive-storage/sku/Google-Drive-storage-20GB/user/alex@example.com",
  "userId": "alex@example.com",
  "productId": "Google-Drive-storage",
  "skuId": "Google-Drive-storage-20GB",
  "skuName": "Google Drive storage 20 GB",
  "productName": "Google Drive storage"
}

詳細については、licenseAssignments の insert method リファレンス ページをご覧ください。

ユーザーの商品 SKU を同じ商品内の別の SKU に再割り当てする

同じサービス内の新しいライセンス SKU にユーザーのライセンスを再割り当てするには、次の PUT HTTP リクエストを使用します。API はパッチ構文もサポートしています。リクエストの承認で説明されているように、Authorization ヘッダーを含めます。サービス ID と SKU ID については、API で利用可能なサービスと SKU をご覧ください。

PUT https://www.googleapis.com/apps/licensing/v1/product/productId/sku/the current skuId/user/user's email

この例では、現在の Google-Drive-storage-20GB SKU を Google-Drive-storage-50GB で更新します。現在のライセンス SKU はリクエストの URI に、新しいライセンス SKU はリクエストの本文に含まれています。

PUT https://www.googleapis.com/apps/licensing/v1/product/Google-Drive-storage/sku/Google-Drive-storage-20GB/user/alex@example.com

JSON リクエストの本文には、次の要素があります。

{
  "kind": "licensing#licenseAssignment",
  "etags": "etag value",
  "selfLink": "https://www.googleapis.com/apps/licensing/v1/product/Google-Drive-storage/sku/Google-Drive-storage-50GB/user/alex@example.com",
  "userId": "alex@example.com",
  "productId": "Google-Drive-storage",
  "skuId": "Google-Drive-storage-50GB",
  "skuName": "Google Drive storage 50 GB",
  "productName": "Google Drive storage"
}

成功すると、200 HTTP ステータス コードが返されます。考えられるエラーコードについては、API のエラーコードをご覧ください。成功すると、ライセンス割り当てステータスが JSON データ形式で返されます。

JSON レスポンス

{
  "kind": "licensing#licenseAssignment",
  "etags": "etag value",
  "selfLink": "https://www.googleapis.com/apps/licensing/v1/product/Google-Drive-storage/sku/Google-Drive-storage-50GB/user/alex@example.com",
  "userId": "alex@example.com",
  "productId": "Google-Drive-storage",
  "skuId": "Google-Drive-storage-50GB",
  "skuName": "Google Drive storage 50 GB",
  "productName": "Google Drive storage"
}

詳細については、licenseAssignments の update メソッドpatch メソッドのリファレンス ページをご覧ください。

特定のプロダクトに割り当てられたすべてのユーザー ライセンスを取得する

特定のサービスのすべてのユーザー ライセンスを取得するには、次の GET HTTP リクエストを使用します。リクエストの承認で説明されているように、Authorization ヘッダーを含めます。customerId クエリ文字列は、顧客のプライマリ ドメイン名です。maxResults クエリ文字列は、API の応答で返されるユーザー ライセンス エントリの数を決定します。

GET https://www.googleapis.com/apps/licensing/v1/product/productId/users?customerId=primary domain name&maxResults=max results per page

サービスと SKU ID については、API で利用可能なサービスと SKU をご覧ください。

この例では、example.com ドメイン内のすべてのユーザーのうち、Google-Drive-storage プロダクトのライセンスが割り当てられているすべてのユーザーの結果の最初のページが一覧表示されます。

GET https://www.googleapis.com/apps/licensing/v1/product/Google-Drive-storage/users?customerId=example.com&maxResults=2

成功すると、200 HTTP ステータス コードが返されます。考えられるエラーコードについては、API のエラーコードをご覧ください。成功すると、ライセンス リストが JSON 形式で返されます。

JSON レスポンス

{
  "kind" : "licensing#licenseAssignmentList",
  "etag": "etag value",
  "nextPageToken" : "the next page token value",
  "items": [
  {
    "kind": "licensing#licenseAssignment",
    "etags": "etag value",
    "selfLink": "https://www.googleapis.com/apps/licensing/v1/product/Google-Drive-storage/sku/Google-Drive-storage-50GB/user/alex@example.com",
    "userId": "alex@example.com",
    "productId": "Google-Drive-storage",
    "skuId": "Google-Drive-storage-50GB",
    "skuName": "Google Drive storage 50 GB",
    "productName": "Google Drive storage"
  },
  {
    "kind": "licensing#licenseAssignment",
    "etags": "etag value",
    "selfLink": "https://www.googleapis.com/apps/licensing/v1/product/Google-Drive-storage/sku/Google-Drive-storage-200GB/user/keshav@example.com",
    "userId": "keshav@example.com",
    "productId": "Google-Drive-storage",
    "skuId": "Google-Drive-storage-200GB",
    "skuName": "Google Drive storage 200 GB",
    "productName": "Google Drive storage"
  },
  ...
}

詳しくは、licenseAssignments の listForProduct メソッド リファレンス ページをご覧ください。

特定のサービスの SKU に割り当てられたすべてのユーザー ライセンスを取得する

特定のサービスの SKU のライセンスを持つすべてのユーザーのリストを取得するには、次の GET HTTP リクエストを使用します。リクエストの承認で説明されているように、Authorization ヘッダーを含めます。customerId クエリ文字列は、顧客のプライマリ ドメイン名です。maxResults クエリ文字列は、API のレスポンスで返されるユーザー エントリの数を決定します。

GET https://www.googleapis.com/apps/licensing/v1/product/productId/sku/skuId/users?customerId=primary domain name&maxResults=max results per response page

サービスと SKU ID については、API で利用可能なサービスと SKU をご覧ください。

この例では、Google-Drive-storage-200GB SKU のライセンスが割り当てられている example.com ドメインのすべてのユーザーの最初のページが返されます。レスポンスには、1 ページあたり 2 つのユーザー エントリがリストされます。

GET https://www.googleapis.com/apps/licensing/v1/product/Google-Drive-storage/sku/Google-Drive-storage-200GB/users?customerId=example.com&maxResults=2

成功すると、200 HTTP ステータス コードが返されます。考えられるエラーコードについては、API のエラーコードをご覧ください。成功すると、ライセンス リストが JSON 形式で返されます。

JSON レスポンス

{
  "kind" : "licensing#licenseAssignmentList",
   "etag": "etag value",
   "nextPageToken" : "next page token's value",
   "items": [
    {
     "kind": "licensing#licenseAssignment",
     "etags": "etag value",
     "selfLink": "https://www.googleapis.com/apps/licensing/v1/product/Google-Drive-storage/sku/Google-Drive-storage-200GB/user/alex@example.com",
     "userId": "alex@example.com",
     "productId": "Google-Drive-storage",
     "skuId": "Google-Drive-storage-200GB",
     "skuName": "Google Drive storage 200 GB",
     "productName": "Google Drive storage"
    },
    {
     "kind": "licensing#licenseAssignment",
     "etags": "etag value",
     "selfLink": "https://www.googleapis.com/apps/licensing/v1/product/Google-Drive-storage/sku/Google-Drive-storage-200GB/user/mary@example.com",
     "userId": "mary@example.com",
     "productId": "Google-Drive-storage",
     "skuId": "Google-Drive-storage-200GB",
     "skuName": "Google Drive storage 200 GB",
     "productName": "Google Drive storage"
    },
    ...
  }

詳しくは、licenseAssignments の listForProductAndSku メソッド リファレンス ページをご覧ください。

サービスの SKU ごとに特定のユーザーのライセンスを取得する

サービスの SKU ごとに特定のユーザーのライセンスを取得するには、次の GET HTTP リクエストを使用します。リクエストの承認で説明されているように、Authorization ヘッダーを含めます。サービス ID と SKU ID については、API で利用可能なサービスと SKU をご覧ください。

GET https://www.googleapis.com/apps/licensing/v1/product/productId/sku/skuId/user/userId

次の例では、userId が alex@example.com のユーザーの Google ドライブ ストレージ 50 GB の商品 SKU を取得します。

GET https://www.googleapis.com/apps/licensing/v1/product/Google-Drive-storage/sku/Google-Drive-storage-50GB/user/alex@example.com

ユーザーがこのライセンスを持っている場合は、正常なレスポンスと 200 HTTP ステータス コードが返されます。考えられるエラーコードについては、API のエラーコードをご覧ください。成功すると、ユーザーのライセンスが JSON 形式で返されます。

JSON レスポンス

{
  "kind": "licensing#licenseAssignment",
  "etag": "etag value",
  "selfLink": "https://www.googleapis.com/apps/licensing/v1/product/Google-Drive-storage/sku/Google-Drive-storage-50GB/user/alex@example.com",
  "userId": "keshav@example.com",
  "productId": "Google-Drive-storage",
  "skuId": "Google-Drive-storage-50GB",
  "skuName": "Google Drive storage 50 GB",
  "productName": "Google Drive storage"
}

詳細については、licenseAssignments get メソッドのリファレンス ページをご覧ください。

ライセンスを削除する

ユーザーからライセンスの割り当てを解除するには、次の DELETE HTTP リクエストを使用します。リクエストの承認で説明されているように、Authorization ヘッダーを含めます。サービス ID と SKU ID については、API で利用可能なサービスと SKU をご覧ください。

DELETE https://www.googleapis.com/apps/licensing/v1/product/productId/sku/skuId/user/userId

次の例では、userId が alex@example.com のユーザーから Google-Drive-storage-50 GB ライセンスの割り当てが解除されています。

DELETE https://www.googleapis.com/apps/licensing/v1/product/Google-Drive-storage/sku/Google-Drive-storage-50GB/user/alex@example.com

成功すると、200 HTTP ステータス コードが返されます。考えられるエラーコードについては、API のエラーコードをご覧ください。

詳細については、licenseAssignments の delete メソッドのリファレンス ページをご覧ください。

エラーコード

リクエストが失敗した場合、レスポンスにはエラーの簡単な説明が含まれます。

エラーコード 説明
400 不正なリクエスト - ユーザーのメールアドレスが無効です。
400 不正なリクエスト - SKU/サービスが存在しません。
401 アクターには、この API を呼び出すための認証情報がありません。
404 ユーザーがこのライセンスを持っていない場合、応答には「見つかりません」と表示されます。表示されます。
412 前提条件が満たされていません。このエラーの詳細については、message フィールドを確認してください。例:
  • Auto License switching is not allowed.
  • Auto License un-assignment is not allowed.
  • For reassign operations, the new SKU should be different from the old SKU: sku
  • Reassign operation can't be performed on different products: product1, product2
  • Reassign operation can't be performed on different users: user1, user2
  • There aren't enough available licenses for the specified product-SKU pair
  • User already has a license for the specified product and SKU
  • User already has a license of the product, but with a different SKU. To reassign a new SKU for this product, use the 'update' operation.
503 License Manager サービスは使用できません。