CMSソースコード

CMSソースコードAPIを使用すると、HubSpotデベロッパー ファイル システムに格納されたファイルを操作できます。これらのファイルには、デザインマネージャーに表示されるテンプレート、モジュール、CSS、JSなどの全てのCMSアセットが含まれます。このAPIでは次の操作ができます。

• 新しいファイルをHubSpotアカウントにアップロードするか、既存のファイル対する変更をアップロードします。
• CMSアセットをアカウントからダウンロードまたは削除します。
• デザインマネージャー内の各ファイルまたは各フォルダーのメタデータを取得します。
• HubSpotのCMS上のファイルの内容（HubL構文を含む）を検証します。
• zipファイルをファイルパッケージとしてアップロードし、アカウント内に展開します。

このAPIでは、全てのCMSアセットをローカル環境で編集するとともに、作業の迅速化に役立つツールを作成できます。 

ソースコードAPIエンドポイントでは、CMSデベロッパー ファイル システム内でのファイルの特定にenvironmentパラメーターとpathパラメーターを使用します。このパラメーターは通常、エンドポイントパス自体に、例えば/cms/v3/source-code/{environment}/content/{path}のように指定します。

environmentパラメーターは、各ファイルの未公開バージョンまたは公開バージョンのいずれを操作するかを示します。未公開のバージョンの場合はdraftを使用します。公開中のバージョンの場合はpublishedを使用します。

pathパラメーターは、CMSデベロッパー ファイル システムでのファイルの位置を示します。UNIXベースのオペレーティングシステムとは異なり、最上位レベルのアセットの前に/文字は付きません。新しいファイルをアップロードする際には、ファイルの作成先となる場所を指定する必要があります。既存のファイルを取得する、または既存のファイルに対する変更をアップロードする場合は、既存のファイルのパスに一致している必要があります。

全てのアセットタイプに、ローカルのファイル形式が使用されます。つまりアセットが、タイプによっては複数のファイルで構成されます。例えば、モジュールは実際には.moduleサフィックスが末尾に付くディレクトリーとして表されます。このため、モジュールのHTMLを取得するには、foo.module/module.htmlのようなパスを使用する必要があります。詳細については、ローカル開発のドキュメントを参照してください。

HubSpotアカウントからは、/cms/v3/source-code/{environment}/content/{path}エンドポイントを使用してファイルをダウンロードできます。

このためには、application/octet-streamコンテンツタイプを受け入れるHTTP GETリクエストを使用します。これにより、指定したパスの実際のバイナリーファイルの内容をダウンロードできます。

例：

• ファイルのダウンロード：
  GET /cms/v3/source-code/published/content/my-file.js
  Accept: application/octet-stream

フォルダーの内容全体をダウンロードすることはできません。代わりに、フォルダーのメタデータを取得し（以下を参照）、子を個別に取得する必要があります。

開発者は/cms/v3/source-code/{environment}/metadata/{path}エンドポイントを使用することで、HubSpotアカウント上のファイルまたはフォルダーのメタデータ（パス、ファイル名、作成／更新時のタイムスタンプなど）を取得できます。

このためには、application/jsonコンテンツタイプを受け入れるHTTP GETリクエストを使用します。これにより、そのファイルの関連メタデータを含むJSONオブジェクトを取得できます。

フォルダーのメタデータは、folder: trueプロパティーにより示されます。children配列は、フォルダー内のファイルとサブフォルダーの名前を示します。これらのファイル名をフォルダーツリーの走査に使用します。1つのフォルダーのメタデータを取得し、そのフォルダーの子と全てのサブフォルダーを再帰的に取得します。

例：

• フォルダーのメタデータを取得する：
  GET /cms/v3/source-code/published/metadata/my-folder
  Accept: application/json

HubSpotアカウントには、/cms/v3/source-code/{environment}/content/{path}エンドポイントを使用してローカルのファイルをアップロードできます。
ファイルは、multipart/form-dataコンテンツタイプを指定したHTTP PUTリクエストによってアップロードする必要があります。バイナリー ファイル データをfileという名前のフィールドとして含める必要があります。

例：

• 新規ファイルをアップロードする：
  PUT /cms/v3/source-code/published/content/my-new-file.html
  Content-Type: multipart/form-data
  フォームデータ：{ file: [バイナリー ファイル データ] }
• 既存の下書きファイルを更新する：
  PUT /cms/v3/source-code/draft/content/path/to/existing-file.html
  Content-Type: multipart/form-data
  フォームデータ：{ file: [バイナリー ファイル データ] }

HubSpotでは現在、以下のCMSアセット ファイル タイプをサポートしています。

• css
• js
• json
• html
• txt
• md
• jpg
• jpeg
• png
• gif
• map
• svg
• ttf
• woff
• woff2

ローカルファイルの内容は、/cms/v3/source-code/{environment}/validate/{path}エンドポイントを使用して検証できます。

これは、テンプレート／モジュール、またはテーマまたはモジュールのJSON内のHubLの検証に使用できます。これにより、デザインマネージャーに表示される警告とエラーが示されます。

ファイルは、multipart/form-dataコンテンツタイプを指定したHTTP POSTリクエストによって送信する必要があります。バイナリー ファイル データをfileという名前のフィールドとして含める必要があります。検証にエラーがあった場合、400レスポンスと関連するエラーのリストが返されます。

例：

• 新規ファイルをアップロードする：
  POST /cms/v3/source-code/published/validate/my-file.html
  Content-Type: multipart/form-data
  フォームデータ：{ file: [バイナリー ファイル データ] }

HubSpotアカウントからは、/cms/v3/source-code/{environment}/content/{path}エンドポイント経由でHTTP DELETEリクエストを使用してファイルを削除できます。

published（公開）環境から削除すると、ファイルは完全に削除されます。draft（下書き）環境から削除すると、未公開の変更が消去されるだけです。公開ファイルを削除すると、使用されていたファイルが公開中のコンテンツに即座に影響を与えます。このため、ファイルに対する全ての参照を削除してから、ファイルを削除してください。

例：

• ファイルを削除する：
  DELETE /cms/v3/source-code/published/content/my-file.html

• zipファイルをアップロードする：
  PUT /cms/v3/source-code/published/content/my-package.zip
  Content-Type: multipart/form-data
  フォームデータ：{ file: [バイナリー ファイル データ] }

• zipファイルを展開する：
  POST /cms/v3/source-code/extract/my-package.zip