Bilibili Sanlian Ads MAPI Material Management (素材管理类)

This skill covers image materials, video materials, submitted videos/archives (稿件), material push, deletion, and material tags. For creative placement and deliverable resource selection, use bilibili-sanlian-ads-metadata; for creative save/update, use bilibili-sanlian-ads-ad-management.

Usage Rules

• Confirm a valid access_token and advertiser account_id first. Use bilibili-sanlian-ads when either is missing.
• Open the matching reference before composing any request. Content types, field locations, upload steps, response IDs, and examples live in references/.
• Business APIs use https://cm.bilibili.com/takumi/api as the root path and usually require Authorization: Bearer {access_token}.
• Every MAPI request must include the custom source header X-Call-Source: sanlian-skills; add it even when a reference example omits it.
• Direct PUT uploads to signed upload URLs are not MAPI requests. Do not add X-Call-Source or other extra custom headers to the signed URL upload unless the signed URL instructions explicitly require them.
• Upload-related APIs have low QPS limits. Upload strictly serially: never run parallel uploads, parallel signed URL PUTs, or concurrent upload/import/create-archive requests.
• Local image upload, image URL import, material push, image delete, signed URL video upload, archive creation, progress polling, and tag operations use different methods and content types. Follow each reference exactly.

Video Concepts

• "Local video" means directly uploading a local video file without publishing it under an uploader/UP owner. When creating a creative with this resource, use template_group_id=4.
• "Submitted video" or "archive" means a投稿稿件 tied to a specified MID/uploader. When creating a creative with this resource, use template_group_id=3.
• If the user mentions a local file path and does not provide a MID, treat it as local video by default and confirm before creative creation.
• If the user provides or asks to use a MID/uploader, treat it as submitted video/archive and confirm the MID before creative creation.

Image Flow

1. Query available image materials when reusing existing assets.
2. Upload a local image or import by remote URL.
3. Capture the returned material ID.
4. Push to another account or bind tags only when requested.
5. Use bilibili-sanlian-ads-ad-management to create or update creatives with the material.

Video And Archive Flow

1. Query signed upload URL.
2. Upload the file with PUT directly to the signed URL. This call does not use the MAPI root path and does not use the source header.
3. Batch create submitted videos/archives (稿件).
4. Poll processing progress. Querying by MD5 is recommended when available.
5. After processing succeeds, use bilibili-sanlian-ads-metadata to select the deliverable archive/video resource, then use bilibili-sanlian-ads-ad-management for creative creation.
6. When creating the creative, use template_group_id=4 for local video and template_group_id=3 for submitted video/archive with MID.

Material Tag Flow

1. Create or query material tags.
2. Bind image/video materials to tags.
3. Query materials under a tag.
4. Update, unbind, or delete tags only when intended by the user.

Source Document Index