Get Multiple Clipping Profile Integrations

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 RequiredIdentifies 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:

NameData TypeDescription
@idStringIndicates the relative path to the requested endpoint.
@typeStringReturns Collection.
itemsList of dictionariesContains a list of clipping profile configurations.
total_itemsIntegerIndicates the total number of clipping profile configurations.

items list

NameData TypeDescription
@idStringIndicates the relative path to an endpoint that returns this clipping profile configuration.
@typeStringReturns ClippingProfileIntegration.
createdStringIdentifies the date and time (UTC) this integration was create.Syntax: {YYYY-MM-DDThh:mm:ss.ssssss}Z Example: 2024-04-04T16:35:46.054Z
lastmodBooleanIdentifies the date and time (UTC) this integration was create. Syntax: {YYYY-MM-DDThh:mm:ss.ssssss}Z Example: 2024-04-04T16:35:46.054Z
nameStringThe name of this clipping profile integration
profileStringGUID representing the clipping profile system-generated ID
serviceStringThe type of third party service
default_libraryStringThis 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
descStringThe description of this profile
idStringIdentifies a clipping profile by its system-defined ID
metamapDictionaryKey/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,
			}