article_conversion_apply
Changes conversion link in the Article app (pApp B00001, or an instance code of the same family). Another app code is refused before any request. Called without confirmToken it previews and returns a confirmToken; repeating the same input with it executes once.
Inputs
| Field | Required here | Contract |
|---|---|---|
action |
Yes | one of: article_conversion_link, article_conversion_link, article_conversion_link (by kind) |
action.postId |
Yes | When action.kind is article_conversion_link: integer; greater than 0 |
action.operation |
Yes | When action.kind is article_conversion_link: initialize |
action.confirmation |
Yes | When action.kind is article_conversion_link: INITIALIZE_ARTICLE_CONVERSION_LINK |
action.postId |
Yes | When action.kind is article_conversion_link: integer; greater than 0 |
action.operation |
Yes | When action.kind is article_conversion_link: edit |
action.confirmation |
Yes | When action.kind is article_conversion_link: CHANGE_ARTICLE_CONVERSION_LINK |
action.changes |
Yes | When action.kind is article_conversion_link: object |
action.changes.title |
No | When action.kind is article_conversion_link: string; min length 1; max length 40 |
action.changes.description |
No | When action.kind is article_conversion_link: string; max length 60 |
action.changes.linkType |
No | When action.kind is article_conversion_link: INTERNAL_LINK, WEB_LINK |
action.changes.destinationUrl |
No | When action.kind is article_conversion_link: string; max length 4096; format uri |
action.changes.enabled |
No | When action.kind is article_conversion_link: boolean |
action.changes.clearThumbnail |
No | When action.kind is article_conversion_link: true |
action.changes.thumbnailUploadTaskId |
No | When action.kind is article_conversion_link: string; pattern ^[A-Za-z0-9_-]{8,80}$; A completed upload task from content_file_upload (uploaded from this computer): Article article_conversion_thumbnail, Photobook photobook_conversion_thumbnail. A Google Drive or other link is downloaded to this computer first; the server never downloads links. |
action.postId |
Yes | When action.kind is article_conversion_link: integer; greater than 0 |
action.operation |
Yes | When action.kind is article_conversion_link: restore |
action.confirmation |
Yes | When action.kind is article_conversion_link: RESTORE_ARTICLE_CONVERSION_LINK |
action.restoreFromTaskId |
Yes | When action.kind is article_conversion_link: string; pattern ^[A-Za-z0-9_-]{8,80}$ |
instanceCode |
No | string; pattern ^B(?:000|9[0-9]{2})01$; Optional: which installed Article app to use (its code, such as B00001 or B90101). Omit it when only one is installed; when several are, pick one from the installed list. |
confirmToken |
No | string; pattern ^ct[a-f\d]{32}$; The confirmToken from this tool's preview result. Omit it to preview; repeat the same input with it to execute. |