Retrieves the list of integrations associated with a specific clipping profile.
Request
Request syntax:
GET /clipping-profiles/Clipping Profile ID/integrations
Define the following variable when submitting the above request:
VariableA variable represents a value that must be replaced. A variable consists of either a URL segment (e.g., "0001" in /0001/) or a query string value (e.g., "3" in mediaTypes=3). | Description |
---|---|
Clipping Profile ID Required | Identifies a clipping profile by its system-defined or external ID. Use the Get Multiple Clipping Profiles endpoint to retrieve a list of clipping profiles and their IDs. |
Response
A successful request returns a 200 OK response that contains the following properties:
Name | Data Type | Description |
---|---|---|
@id | String | Indicates the relative path to the requested endpoint. |
@type | String | Returns Collection. |
items | List of dictionaries | Contains a list of clipping profile configurations. |
total_items | Integer | Indicates the total number of clipping profile configurations. |
items list
Name | Data Type | Description |
---|---|---|
@id | String | Indicates the relative path to an endpoint that returns this clipping profile configuration. |
@type | String | Returns ClippingProfileIntegration. |
created | String | Identifies the date and time (UTC) this integration was create.Syntax: {YYYY-MM-DDThh:mm:ss.ssssss}Z Example: 2024-04-04T16:35:46.054Z |
lastmod | Boolean | Identifies the date and time (UTC) this integration was create. Syntax: {YYYY-MM-DDThh:mm:ss.ssssss}Z Example: 2024-04-04T16:35:46.054Z |
name | String | The name of this clipping profile integration |
profile | String | GUID representing the clipping profile system-generated ID |
service | String | The type of third party service |
default_library | String | This will be a GUID that represents a Library. This is used in CMS to display a shorter list of assets when trying to decide what intro/outro bumper to use |
desc | String | The description of this profile |
id | String | Identifies a clipping profile by its system-defined ID |
metamap | Dictionary | Key/Value[String] pairs contain the following keys: category, description, keywords, privacyStatus, profile_id and title |
Sample Request/Response
Call the clipping_profiles_integrations_get module (Python 3) to retrieve one or more profile integrations. This module imports names from the api_auth module.
Request:
from pprint import PrettyPrinter
import requests
from api_auth import APICredentials, APIParams
pp = PrettyPrinter().pprint
class ClippingProfiles:
"""Class Description"""
def __init__(self, source_list):
"""dummy"""
self.profile_id = None
for key, value in source_list.items():
setattr(self, key, value)
self.host = "https://services.uplynk.com"
self.headers = {"Content-Type": "application/json"}
def run(self):
"""dummy"""
self._get_youtube_login_url()
def _get_youtube_login_url(self):
"""dummy"""
url = f"{self.host}/api/v4/clipping-profiles/{self.profile_id}/integrations"
query_params = {
"profile_id": self.profile_id,
}
query_params = {}
response = requests.get(
url,
params=APIParams(APICredentials()).get_params(query_params),
headers=self.headers,
timeout=15
)
pp(response.json())
class_variables = {"profile_id": "be1af15490e24399bb6c4f2a36384d66"}
ClippingProfiles(class_variables).run()
Response:
{
"@id": "/api/v4/clipping-profiles/be1af15490e24399bb6c4f2a36384d66/integrations",
"@type": "Collection",
"items": [
{
"@id": "/api/v4/clipping-profiles/be1af15490e24399bb6c4f2a36384d66/integrations/c3eb485e9b374945a623abc3b883eb78",
"@type": "ClippingProfileIntegrations",
"authenticated": False,
"created": "2024-05-07T15:48:18.982Z",
"id": "c3eb485e9b374945a623abc3b883eb78",
"lastmod": "2024-05-07T16:18:10.257Z",
"metamap": {
"category": "$blue_colors",
"description": "@desc",
"keywords": "$blue_colors",
"privacyStatus": "",
"title": "@desc",
},
"name": "My Youtube",
"profile": "be1af15490e24399bb6c4f2a36384d66",
"service": "youtube",
}
],
"search_version": 3,
"total_items": 1,
}