CreativeAssets: insert

新しいクリエイティブ アセットを挿入します。実習をご覧ください。

このメソッドは /upload URI をサポートします。次の特性を持つメディアのアップロードが可能です。

  • 最大ファイルサイズ: 1,024 MB
  • 有効なメディア MIME タイプ:
    application/octet-stream
    application/x-zip
    application/zip
    image/*
    text/html
    text/plain
    text/xml
    video/*

リクエスト

HTTP リクエスト

このメソッドは、2 つの別個の URI を使用するメディアのアップロード機能を提供します。詳細については、メディアのアップロードのドキュメントをご覧ください。

  • /upload URI（メディアのアップロード リクエスト用）: 
    POST https://www.googleapis.com/upload/dfareporting/v3.4/userprofiles/profileId/creativeAssets/advertiserId/creativeAssets
  • メタデータ URI（メタデータのみのリクエスト用）: 
    POST https://www.googleapis.com/dfareporting/v3.4/userprofiles/profileId/creativeAssets/advertiserId/creativeAssets

パラメータ

パラメータ名 値 説明
パス パラメータ
advertiserId long このクリエイティブの広告主 ID。必須フィールドです。
profileId long このリクエストに関連付けられるユーザー プロフィール ID。
必須のクエリ パラメータ
uploadType string /upload URI に対するアップロード リクエストのタイプ。/upload URI を使用してデータをアップロードする場合、このフィールドは必須です。メタデータのみのファイルを作成する場合、このフィールドは必須ではありません。また、[Try this API] ウィジェットはデータのアップロードに対応していないため、このフィールドは表示されません。 設定可能な値は次のとおりです。
  • media - シンプル アップロード。メタデータなしで、メディアのみをアップロードします。
  • multipart - マルチパート アップロード。単一のリクエストで、メディアとそのメタデータの両方をアップロードします。
  • resumable - 再開可能アップロード。再開可能な方法でファイルをアップロードします。2 つ以上の連続するリクエストを使用し、最初のリクエストでメタデータを送信します。

認証

このリクエストには、次のスコープによる認証が必要です。

スコープ
https://www.googleapis.com/auth/dfatrafficking

詳しくは、認証と認可のページをご覧ください。

リクエストの本文

リクエストの本文に、CreativeAssets リソースをメタデータとして指定します。詳細については、メディアのアップロードのドキュメントをご覧ください。

レスポンス

成功すると、このメソッドはレスポンスの本文で CreativeAssets リソースを返します。

実習

注: 現在、API Explorer ではメタデータ リクエストのみがサポートされています。

以下の API Explorer を使用し、ライブデータに対してこのメソッドを呼び出して、レスポンスを確認してみましょう。