Images
Retrieves metadata for image assets in your LinkedIn Ads account, including identifiers, upload details, and ownership information.
Table Specific Information
Select
For the AccountURN column, the = operator is fully supported server-side. The IN operator is partially supported server-side and partially client-side. Refer to the query examples below:SELECT * FROM Images WHERE AccountURN = 'urn:li:sponsoredAccount:512859024';
SELECT * FROM Images WHERE AccountURN IN ('urn:li:sponsoredAccount:512859024', 'urn:li:sponsoredAccount:513009855')
For the URN column, the = operator is fully supported server-side. The IN operator is partially supported server-side and partially client-side. Refer to the query examples below:
SELECT * FROM Images WHERE URN = 'urn:li:image:D4D10AQHqn3iVssgwvA';
SELECT * FROM Images WHERE URN IN ('urn:li:image:D4D10AQHqn3iVssgwvA', 'urn:li:image:D4D10AQGGB-vB21hq4g')
For the two queries above, the values for the AccountURN, MediaLibraryName, and MediaLibraryStatus columns are not returned (always null).
When no criteria is specified as shown below:
SELECT * FROM Images;
we internally post-process the query to the following before executing:
SELECT * FROM Images WHERE AccountURN IN (SELECT URN FROM Accounts);
The rest of the query is processed client-side.
Update
To modify an existing image, use an UPDATE statement. Note that the URN column and the AccountURN column are required in the WHERE clause.The following columns are the ones that are changeable after creation:
- MediaLibraryName
- MediaLibraryStatus
UPDATE Images SET MediaLibraryName = 'My Test Image', MediaLibraryStatus = 'ARCHIVED' WHERE AccountURN = 'urn:li:sponsoredAccount:513009855' AND URN = 'urn:li:image:D4D10AQHqn3iVssgwvA'
Columns
| Name | Type | ReadOnly | References | Description |
| URN [KEY] | String | True |
Uniform Resource Name (URN) that uniquely identifies the image asset within LinkedIn. | |
| AccountURN | String | True |
URN that identifies the advertising account associated with the image asset. | |
| MediaLibraryName | String | False |
Display name of the image asset as it appears in the media library. | |
| MediaLibraryStatus | String | False |
Indicates the current status of the image asset in the media library, such as active or archived. The allowed values are ACTIVE, ARCHIVED. | |
| OwnerURN | String | True |
URN that identifies the entity or account that owns the image asset. | |
| DownloadURL | String | True |
URL used to download the image file from LinkedIn's asset library. | |
| DownloadURLExpiresAt | Datetime | True |
Date and time when the download URL for the image asset expires and is no longer valid. | |
| Status | String | True |
Represents the current processing or availability status of the image asset. The allowed values are PROCESSING, PROCESSING_FAILED, AVAILABLE, WAITING_UPLOAD. |