get_ad_details

Get complete details and configuration for one or more ads from the Metadata platform.

                    USAGE INSTRUCTIONS FOR LLM:
                    Use this tool when users want to:
                    - Get complete ad details by ad ID
                    - Retrieve ad configuration including content, targeting, and creative assets
                    - Check existing ad settings before making modifications
                    - Analyze ad performance data and configuration
                    - Get creative library information associated with ads
                    - Extract ad content like text, headline, CTA, links for reference
                    - the value returned libraryCreative labelName corresponds to the library/image name.

                    WHEN TO USE:
                    - User asks "show me ad details for ID X"
                    - User wants to see ad configuration: "what's in ad 182124?"
                    - User needs ad content: "get the text/headline/CTA from ad Y"
                    - User wants to check ad settings before editing
                    - User asks "what creative is used in ad Z?"
                    - User needs to analyze existing ad setup

                    INPUT PARAMETERS:
                    - ids: Flexible format for specifying ad IDs:
                        * Single integer: 182124
                        * Comma-separated string: "182124,182123,182125"

                    EXAMPLE CALLS:
                    - get_ad_details(ids=182124) (single)
                    - get_ad_details(ids="182124,182123,182125") (multiple)

                    DETAILED RESPONSE INCLUDES:
                    AD CONFIGURATION:
                    - Basic info: id, name, channelType (FACEBOOK/LINKEDIN), adType (IMAGE/VIDEO/etc.)
                    - Status: completionStatus, aiState, renameAllowed

                    AD CONTENT:
                    - text: Main ad copy/body text
                    - headline: Ad headline text
                    - link: Landing page URL
                    - description: Additional ad description
                    - ctaType: Call-to-action button (e.g., "Get_Demo", "Learn_More")

                    CREATIVE ASSET DETAILS:
                    - libraryId: Creative asset ID reference
                    - libraryCreative object with:
                        - id, labelName (filename)
                        - url: Full-size creative asset URL
                        - thumbnail: Thumbnail URL
                        - dimensions: width, height in pixels
                        - sizeInKb: File size
                        - content_type: image/png, image/jpeg, etc.
                        - created_date: When creative was uploaded

                    METADATA:
                    - tags: Ad tags/labels
                    - created/modified dates
                    - AI processing state

                    ERROR HANDLING:
                    - If ad ID doesn't exist, API returns empty array
                    - Always validate that IDs are integers before making request
                    - Handle both single ID and multiple ID requests

                    EXAMPLE USAGE:
                    - get_ad_details(ids=182124) - Single ad by integer
                    - get_ad_details(ids="182124,182123,182125") - Multiple ads by comma-separated string