Skip to main content

​
Canva

ShanoneのCanva連携は、Canva Connect APIを扱う36個のツールをエージェントに提供します。デザイン、アセット、フォルダ、ブランドテンプレート、オートフィルジョブ、インポート/エクスポート、コメントが対象です。

​
はじめに

1

OAuthで接続する

エージェントにCanva関連の作業を依頼(例: 「最近のデザインを一覧表示して」)するか、Shanoneダッシュボードの連携から事前に接続します。どちらの場合も、ShanoneのCanvaアプリを許可するためのconnect_linkが発行されます。
2

Canvaアカウントを許可する

Shanoneに操作させたいアカウントについて、CanvaのOAuth同意画面を承認します。
3

リクエストを再実行する

接続が完了すると、canva_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはCanva向けに36個のツールを、以下のカテゴリに整理して提供しています。
canva_list_designs, canva_get_design, canva_create_design, canva_get_design_pages
canva_list_assets, canva_upload_asset, canva_get_asset_upload_job, canva_create_url_asset_upload_job, canva_get_url_asset_upload_job, canva_update_asset, canva_delete_asset
canva_create_folder, canva_list_folders, canva_get_folder, canva_update_folder, canva_delete_folder, canva_move_folder_item
canva_list_brand_templates, canva_get_brand_template, canva_get_brand_template_dataset, canva_create_design_autofill_job, canva_get_design_autofill_job
canva_export_design, canva_get_export_status, canva_create_design_resize_job, canva_get_design_resize_job
canva_create_design_import_job, canva_get_design_import_job, canva_create_url_import_job, canva_get_url_import_job
canva_create_comment, canva_list_comments
canva_get_user_profile, canva_get_user_capabilities, canva_introspect_token, canva_revoke_token

​
よくあるユースケース

ブランド統一されたアセット生成

ブランドテンプレートにキャンペーンデータをオートフィルして、ブランドに沿ったデザインを量産する

一括エクスポート

複数のデザインをPNG/PDFにまとめて書き出し、各エクスポートジョブの完了を追跡する

アセットライブラリの整理

共有フォルダをまたいでアセットをアップロード・整理・整理整頓する

デザインレビューワークフロー

デザインのコメントを一覧表示し、レビュアー向けのフォローアップコメントを追加する

​
トラブルシューティング

dataペイロードのフィールド名と型は、ブランドテンプレートのデータセットと完全に一致している必要があります。オートフィルを呼び出す前に、まずcanva_get_brand_template_datasetで期待されるフィールドを確認してください。
Canva Connect APIのジョブ(エクスポート、リサイズ、インポート、オートフィル)は非同期処理です。即座に結果が返ることを期待せず、対応する_get_*_job/_get_export_statusツールをステータスがsuccessまたはfailedになるまでポーリングしてください。
アセットのアップロード(canva_upload_asset、canva_create_url_asset_upload_job)は非同期で処理されます。アセットが使用可能になる前に、canva_get_asset_upload_job / canva_get_url_asset_upload_jobで完了を確認してください。