ghl_sdk/services/

ad_manager.rs

// @generated by xtask/generate_services.py — do not edit by hand.
//! `ad-manager` — typed methods for all 94 API v2 operations
//! in this module.
//!
//! Access via [`Ghl::ad_manager`](crate::Ghl::ad_manager).
//!
//! Request and response types come from [`ghl_models::v2::ad_manager`](https://docs.rs/ghl-models/latest/ghl_models/v2/ad_manager/); every endpoint is also documented in the
//! [`ad-manager` API reference](https://github.com/Shahroz/ghl-rs/blob/main/docs/api/ad-manager.md).
//!
//! Enable with `features = ["ad-manager"]`.

#![allow(clippy::too_many_arguments)]

use crate::client::Ghl;
use crate::error::Result;
use ghl_models::v2::ad_manager as models;

/// Typed access to the `ad-manager` API v2 surface (94 operations). Obtained via
/// [`Ghl::ad_manager`](crate::Ghl::ad_manager).
#[derive(Debug, Clone)]
pub struct AdManagerService {
    pub(crate) client: Ghl,
}

impl AdManagerService {
    pub(crate) fn new(client: Ghl) -> Self {
        Self { client }
    }
}

/// Query parameters for [`AdManagerService::get_ad_accounts`].
#[derive(Debug, Clone, Default)]
pub struct GetAdAccountsParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Account source type
    pub type_: Option<String>,
    /// Pagination cursor
    pub next: Option<String>,
    /// Fetch all accounts
    pub fetch_all: Option<String>,
    /// Results page limit
    pub limit: Option<String>,
}

impl GetAdAccountsParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            ..Default::default()
        }
    }

    /// Account source type
    pub fn type_(mut self, v: impl Into<String>) -> Self {
        self.type_ = Some(v.into());
        self
    }

    /// Pagination cursor
    pub fn next(mut self, v: impl Into<String>) -> Self {
        self.next = Some(v.into());
        self
    }

    /// Fetch all accounts
    pub fn fetch_all(mut self, v: impl Into<String>) -> Self {
        self.fetch_all = Some(v.into());
        self
    }

    /// Results page limit
    pub fn limit(mut self, v: impl Into<String>) -> Self {
        self.limit = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        if let Some(v) = &self.type_ {
            q.push(("type".into(), v.to_string()));
        }
        if let Some(v) = &self.next {
            q.push(("next".into(), v.to_string()));
        }
        if let Some(v) = &self.fetch_all {
            q.push(("fetchAll".into(), v.to_string()));
        }
        if let Some(v) = &self.limit {
            q.push(("limit".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::get_ad_account_details`].
#[derive(Debug, Clone, Default)]
pub struct GetAdAccountDetailsParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetAdAccountDetailsParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_campaign_with_linked_entities`].
#[derive(Debug, Clone, Default)]
pub struct GetCampaignWithLinkedEntitiesParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Comma-separated field names
    pub fields: Option<String>,
    /// Campaign data source
    pub source: Option<String>,
}

impl GetCampaignWithLinkedEntitiesParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            ..Default::default()
        }
    }

    /// Comma-separated field names
    pub fn fields(mut self, v: impl Into<String>) -> Self {
        self.fields = Some(v.into());
        self
    }

    /// Campaign data source
    pub fn source(mut self, v: impl Into<String>) -> Self {
        self.source = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        if let Some(v) = &self.fields {
            q.push(("fields".into(), v.to_string()));
        }
        if let Some(v) = &self.source {
            q.push(("source".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::get_conversation_forms`].
#[derive(Debug, Clone, Default)]
pub struct GetConversationFormsParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetConversationFormsParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_custom_audiences`].
#[derive(Debug, Clone, Default)]
pub struct GetCustomAudiencesParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Audience list type
    /// Allowed values: `lookalike`, `custom`, `all`.
    /// Required by the API.
    pub type_: String,
    /// Audience data source
    /// Allowed values: `ad_manager`, `integration`.
    pub source: Option<String>,
    /// Ad account identifier
    /// Required by the API.
    pub ad_account_id: String,
}

impl GetCustomAudiencesParams {
    /// Start from the parameters the API requires.
    pub fn new(
        location_id: impl Into<String>,
        type_: impl Into<String>,
        ad_account_id: impl Into<String>,
    ) -> Self {
        Self {
            location_id: location_id.into(),
            type_: type_.into(),
            ad_account_id: ad_account_id.into(),
            ..Default::default()
        }
    }

    /// Audience data source
    pub fn source(mut self, v: impl Into<String>) -> Self {
        self.source = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("type".into(), self.type_.clone()),
            ("adAccountId".into(), self.ad_account_id.clone()),
        ];
        if let Some(v) = &self.source {
            q.push(("source".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::delete_custom_audience`].
#[derive(Debug, Clone, Default)]
pub struct DeleteCustomAudienceParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl DeleteCustomAudienceParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_custom_audience_by_id`].
#[derive(Debug, Clone, Default)]
pub struct GetCustomAudienceByIdParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetCustomAudienceByIdParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_entities`].
#[derive(Debug, Clone, Default)]
pub struct GetEntitiesParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Integration source type
    /// Allowed values: `AD_MANAGER`, `INTEGRATION`.
    /// Required by the API.
    pub type_: String,
    /// Pagination cursor
    pub next: Option<String>,
    /// Fetch all entities
    pub fetch_all: Option<String>,
    /// Campaign identifier
    pub campaign_id: Option<String>,
    /// Ad set identifier
    pub ad_set_id: Option<String>,
    /// Entity type to fetch
    /// Allowed values: `CAMPAIGN`, `ADSET`, `AD`.
    /// Required by the API.
    pub entity_type: String,
    /// Search identifier
    pub search_id: Option<String>,
    /// Selected ad account ID
    pub selected_ad_account_id: Option<String>,
}

impl GetEntitiesParams {
    /// Start from the parameters the API requires.
    pub fn new(
        location_id: impl Into<String>,
        type_: impl Into<String>,
        entity_type: impl Into<String>,
    ) -> Self {
        Self {
            location_id: location_id.into(),
            type_: type_.into(),
            entity_type: entity_type.into(),
            ..Default::default()
        }
    }

    /// Pagination cursor
    pub fn next(mut self, v: impl Into<String>) -> Self {
        self.next = Some(v.into());
        self
    }

    /// Fetch all entities
    pub fn fetch_all(mut self, v: impl Into<String>) -> Self {
        self.fetch_all = Some(v.into());
        self
    }

    /// Campaign identifier
    pub fn campaign_id(mut self, v: impl Into<String>) -> Self {
        self.campaign_id = Some(v.into());
        self
    }

    /// Ad set identifier
    pub fn ad_set_id(mut self, v: impl Into<String>) -> Self {
        self.ad_set_id = Some(v.into());
        self
    }

    /// Search identifier
    pub fn search_id(mut self, v: impl Into<String>) -> Self {
        self.search_id = Some(v.into());
        self
    }

    /// Selected ad account ID
    pub fn selected_ad_account_id(mut self, v: impl Into<String>) -> Self {
        self.selected_ad_account_id = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("type".into(), self.type_.clone()),
            ("entityType".into(), self.entity_type.clone()),
        ];
        if let Some(v) = &self.next {
            q.push(("next".into(), v.to_string()));
        }
        if let Some(v) = &self.fetch_all {
            q.push(("fetchAll".into(), v.to_string()));
        }
        if let Some(v) = &self.campaign_id {
            q.push(("campaignId".into(), v.to_string()));
        }
        if let Some(v) = &self.ad_set_id {
            q.push(("adSetId".into(), v.to_string()));
        }
        if let Some(v) = &self.search_id {
            q.push(("searchId".into(), v.to_string()));
        }
        if let Some(v) = &self.selected_ad_account_id {
            q.push(("selectedAdAccountId".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::get_facebook_integration`].
#[derive(Debug, Clone, Default)]
pub struct GetFacebookIntegrationParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetFacebookIntegrationParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_lead_form_by_id`].
#[derive(Debug, Clone, Default)]
pub struct GetLeadFormByIdParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetLeadFormByIdParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_current_facebook_user`].
#[derive(Debug, Clone, Default)]
pub struct GetCurrentFacebookUserParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetCurrentFacebookUserParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::delete_page_connection`].
#[derive(Debug, Clone, Default)]
pub struct DeletePageConnectionParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Facebook page ID
    /// Required by the API.
    pub page_id: String,
}

impl DeletePageConnectionParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>, page_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            page_id: page_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("pageId".into(), self.page_id.clone()),
        ];
        q
    }
}

/// Query parameters for [`AdManagerService::set_default_page`].
#[derive(Debug, Clone, Default)]
pub struct SetDefaultPageParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl SetDefaultPageParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_page_lead_forms`].
#[derive(Debug, Clone, Default)]
pub struct GetPageLeadFormsParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetPageLeadFormsParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_instagram_accounts_for_page`].
#[derive(Debug, Clone, Default)]
pub struct GetInstagramAccountsForPageParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Integration type
    /// Allowed values: `INTEGRATION`, `AD_MANAGER`.
    pub type_: Option<String>,
}

impl GetInstagramAccountsForPageParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            ..Default::default()
        }
    }

    /// Integration type
    pub fn type_(mut self, v: impl Into<String>) -> Self {
        self.type_ = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        if let Some(v) = &self.type_ {
            q.push(("type".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::get_facebook_pages`].
#[derive(Debug, Clone, Default)]
pub struct GetFacebookPagesParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Fetch existing pages flag
    pub fetch_existing: Option<String>,
}

impl GetFacebookPagesParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            ..Default::default()
        }
    }

    /// Fetch existing pages flag
    pub fn fetch_existing(mut self, v: impl Into<String>) -> Self {
        self.fetch_existing = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        if let Some(v) = &self.fetch_existing {
            q.push(("fetchExisting".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::get_conversion_pixels`].
#[derive(Debug, Clone, Default)]
pub struct GetConversionPixelsParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Channel type
    pub channel: Option<String>,
    /// Facebook page ID
    pub page_id: Option<String>,
    /// Instagram user ID
    pub ig_user_id: Option<String>,
}

impl GetConversionPixelsParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            ..Default::default()
        }
    }

    /// Channel type
    pub fn channel(mut self, v: impl Into<String>) -> Self {
        self.channel = Some(v.into());
        self
    }

    /// Facebook page ID
    pub fn page_id(mut self, v: impl Into<String>) -> Self {
        self.page_id = Some(v.into());
        self
    }

    /// Instagram user ID
    pub fn ig_user_id(mut self, v: impl Into<String>) -> Self {
        self.ig_user_id = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        if let Some(v) = &self.channel {
            q.push(("channel".into(), v.to_string()));
        }
        if let Some(v) = &self.page_id {
            q.push(("pageId".into(), v.to_string()));
        }
        if let Some(v) = &self.ig_user_id {
            q.push(("igUserId".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::get_reporting_data`].
#[derive(Debug, Clone, Default)]
pub struct GetReportingDataParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Time grouping interval
    /// Allowed values: `day`, `week`, `month`.
    /// Required by the API.
    pub group_by: String,
    /// Report start date
    /// Required by the API.
    pub start_date: String,
    /// Report end date
    /// Required by the API.
    pub end_date: String,
    /// Integration source type
    /// Allowed values: `AD_MANAGER`, `INTEGRATION`.
    /// Required by the API.
    pub type_: String,
    /// Comma-separated reporting fields
    /// Required by the API.
    pub fields: String,
}

impl GetReportingDataParams {
    /// Start from the parameters the API requires.
    pub fn new(
        location_id: impl Into<String>,
        group_by: impl Into<String>,
        start_date: impl Into<String>,
        end_date: impl Into<String>,
        type_: impl Into<String>,
        fields: impl Into<String>,
    ) -> Self {
        Self {
            location_id: location_id.into(),
            group_by: group_by.into(),
            start_date: start_date.into(),
            end_date: end_date.into(),
            type_: type_.into(),
            fields: fields.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("groupBy".into(), self.group_by.clone()),
            ("startDate".into(), self.start_date.clone()),
            ("endDate".into(), self.end_date.clone()),
            ("type".into(), self.type_.clone()),
            ("fields".into(), self.fields.clone()),
        ];
        q
    }
}

/// Query parameters for [`AdManagerService::get_campaign_reporting`].
#[derive(Debug, Clone, Default)]
pub struct GetCampaignReportingParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Report start date
    /// Required by the API.
    pub start_date: String,
    /// Report end date
    /// Required by the API.
    pub end_date: String,
}

impl GetCampaignReportingParams {
    /// Start from the parameters the API requires.
    pub fn new(
        location_id: impl Into<String>,
        start_date: impl Into<String>,
        end_date: impl Into<String>,
    ) -> Self {
        Self {
            location_id: location_id.into(),
            start_date: start_date.into(),
            end_date: end_date.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("startDate".into(), self.start_date.clone()),
            ("endDate".into(), self.end_date.clone()),
        ];
        q
    }
}

/// Query parameters for [`AdManagerService::get_reporting_list`].
#[derive(Debug, Clone, Default)]
pub struct GetReportingListParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Reporting list type
    /// Required by the API.
    pub list_type: String,
    /// Report start date
    /// Required by the API.
    pub start_date: String,
    /// Report end date
    /// Required by the API.
    pub end_date: String,
    /// Campaign identifier
    /// Required by the API.
    pub campaign_id: String,
    /// Integration source type
    /// Allowed values: `AD_MANAGER`, `INTEGRATION`.
    /// Required by the API.
    pub type_: String,
}

impl GetReportingListParams {
    /// Start from the parameters the API requires.
    pub fn new(
        location_id: impl Into<String>,
        list_type: impl Into<String>,
        start_date: impl Into<String>,
        end_date: impl Into<String>,
        campaign_id: impl Into<String>,
        type_: impl Into<String>,
    ) -> Self {
        Self {
            location_id: location_id.into(),
            list_type: list_type.into(),
            start_date: start_date.into(),
            end_date: end_date.into(),
            campaign_id: campaign_id.into(),
            type_: type_.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("listType".into(), self.list_type.clone()),
            ("startDate".into(), self.start_date.clone()),
            ("endDate".into(), self.end_date.clone()),
            ("campaignId".into(), self.campaign_id.clone()),
            ("type".into(), self.type_.clone()),
        ];
        q
    }
}

/// Query parameters for [`AdManagerService::search_targeting_options`].
#[derive(Debug, Clone, Default)]
pub struct SearchTargetingOptionsParams {
    /// Targeting search type
    /// Required by the API.
    pub type_: String,
    /// Search query string
    /// Required by the API.
    pub query: String,
    /// Specific search subtype
    pub search_type: Option<String>,
}

impl SearchTargetingOptionsParams {
    /// Start from the parameters the API requires.
    pub fn new(type_: impl Into<String>, query: impl Into<String>) -> Self {
        Self {
            type_: type_.into(),
            query: query.into(),
            ..Default::default()
        }
    }

    /// Specific search subtype
    pub fn search_type(mut self, v: impl Into<String>) -> Self {
        self.search_type = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![
            ("type".into(), self.type_.clone()),
            ("query".into(), self.query.clone()),
        ];
        if let Some(v) = &self.search_type {
            q.push(("searchType".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::get_google_ad_accounts`].
#[derive(Debug, Clone, Default)]
pub struct GetGoogleAdAccountsParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Account type
    /// Allowed values: `INTEGRATION`, `AD_MANAGER`.
    pub type_: Option<String>,
}

impl GetGoogleAdAccountsParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            ..Default::default()
        }
    }

    /// Account type
    pub fn type_(mut self, v: impl Into<String>) -> Self {
        self.type_ = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        if let Some(v) = &self.type_ {
            q.push(("type".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::get_ad_account_details_op`].
#[derive(Debug, Clone, Default)]
pub struct GetAdAccountDetailsOpParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetAdAccountDetailsOpParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_google_campaign_by_id`].
#[derive(Debug, Clone, Default)]
pub struct GetGoogleCampaignByIdParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetGoogleCampaignByIdParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_assets`].
#[derive(Debug, Clone, Default)]
pub struct GetAssetsParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Asset type to retrieve
    /// Allowed values: `CALL`, `SITELINK`, `LEAD_FORM`, `IMAGE`, `TEXT`.
    /// Required by the API.
    pub type_: String,
    /// Asset identifier
    pub id: Option<String>,
    /// Advertiser only flag
    pub advertiser_only: Option<String>,
}

impl GetAssetsParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>, type_: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            type_: type_.into(),
            ..Default::default()
        }
    }

    /// Asset identifier
    pub fn id(mut self, v: impl Into<String>) -> Self {
        self.id = Some(v.into());
        self
    }

    /// Advertiser only flag
    pub fn advertiser_only(mut self, v: impl Into<String>) -> Self {
        self.advertiser_only = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("type".into(), self.type_.clone()),
        ];
        if let Some(v) = &self.id {
            q.push(("id".into(), v.to_string()));
        }
        if let Some(v) = &self.advertiser_only {
            q.push(("advertiserOnly".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::get_audiences`].
#[derive(Debug, Clone, Default)]
pub struct GetAudiencesParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetAudiencesParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_audience_by_id`].
#[derive(Debug, Clone, Default)]
pub struct GetAudienceByIdParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetAudienceByIdParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_conversion_goals`].
#[derive(Debug, Clone, Default)]
pub struct GetConversionGoalsParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetConversionGoalsParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_conversions`].
#[derive(Debug, Clone, Default)]
pub struct GetConversionsParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Integration type
    /// Allowed values: `AD_MANAGER`, `AD_WORDS`.
    pub type_: Option<String>,
    /// Conversion type
    pub conversion_type: Option<String>,
    /// Conversion category
    pub category: Option<String>,
    /// Filter start date
    pub start_date: Option<String>,
    /// Filter end date
    pub end_date: Option<String>,
}

impl GetConversionsParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            ..Default::default()
        }
    }

    /// Integration type
    pub fn type_(mut self, v: impl Into<String>) -> Self {
        self.type_ = Some(v.into());
        self
    }

    /// Conversion type
    pub fn conversion_type(mut self, v: impl Into<String>) -> Self {
        self.conversion_type = Some(v.into());
        self
    }

    /// Conversion category
    pub fn category(mut self, v: impl Into<String>) -> Self {
        self.category = Some(v.into());
        self
    }

    /// Filter start date
    pub fn start_date(mut self, v: impl Into<String>) -> Self {
        self.start_date = Some(v.into());
        self
    }

    /// Filter end date
    pub fn end_date(mut self, v: impl Into<String>) -> Self {
        self.end_date = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        if let Some(v) = &self.type_ {
            q.push(("type".into(), v.to_string()));
        }
        if let Some(v) = &self.conversion_type {
            q.push(("conversionType".into(), v.to_string()));
        }
        if let Some(v) = &self.category {
            q.push(("category".into(), v.to_string()));
        }
        if let Some(v) = &self.start_date {
            q.push(("startDate".into(), v.to_string()));
        }
        if let Some(v) = &self.end_date {
            q.push(("endDate".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::delete_conversion`].
#[derive(Debug, Clone, Default)]
pub struct DeleteConversionParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl DeleteConversionParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_conversion_by_id`].
#[derive(Debug, Clone, Default)]
pub struct GetConversionByIdParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetConversionByIdParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_entities_op`].
#[derive(Debug, Clone, Default)]
pub struct GetEntitiesOpParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Integration type
    /// Allowed values: `AD_MANAGER`, `INTEGRATION`.
    /// Required by the API.
    pub type_: String,
    /// Campaign identifier
    pub campaign_id: Option<String>,
    /// Ad group identifier
    pub ad_group_id: Option<String>,
    /// Entity type
    /// Allowed values: `CAMPAIGN`, `ADGROUP`, `AD`.
    /// Required by the API.
    pub entity_type: String,
    /// Search identifier
    pub search_id: Option<String>,
    /// Filter start date
    pub start_date: Option<String>,
    /// Filter end date
    pub end_date: Option<String>,
    /// Selected ad account ID
    pub selected_ad_account_id: Option<String>,
}

impl GetEntitiesOpParams {
    /// Start from the parameters the API requires.
    pub fn new(
        location_id: impl Into<String>,
        type_: impl Into<String>,
        entity_type: impl Into<String>,
    ) -> Self {
        Self {
            location_id: location_id.into(),
            type_: type_.into(),
            entity_type: entity_type.into(),
            ..Default::default()
        }
    }

    /// Campaign identifier
    pub fn campaign_id(mut self, v: impl Into<String>) -> Self {
        self.campaign_id = Some(v.into());
        self
    }

    /// Ad group identifier
    pub fn ad_group_id(mut self, v: impl Into<String>) -> Self {
        self.ad_group_id = Some(v.into());
        self
    }

    /// Search identifier
    pub fn search_id(mut self, v: impl Into<String>) -> Self {
        self.search_id = Some(v.into());
        self
    }

    /// Filter start date
    pub fn start_date(mut self, v: impl Into<String>) -> Self {
        self.start_date = Some(v.into());
        self
    }

    /// Filter end date
    pub fn end_date(mut self, v: impl Into<String>) -> Self {
        self.end_date = Some(v.into());
        self
    }

    /// Selected ad account ID
    pub fn selected_ad_account_id(mut self, v: impl Into<String>) -> Self {
        self.selected_ad_account_id = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("type".into(), self.type_.clone()),
            ("entityType".into(), self.entity_type.clone()),
        ];
        if let Some(v) = &self.campaign_id {
            q.push(("campaignId".into(), v.to_string()));
        }
        if let Some(v) = &self.ad_group_id {
            q.push(("adGroupId".into(), v.to_string()));
        }
        if let Some(v) = &self.search_id {
            q.push(("searchId".into(), v.to_string()));
        }
        if let Some(v) = &self.start_date {
            q.push(("startDate".into(), v.to_string()));
        }
        if let Some(v) = &self.end_date {
            q.push(("endDate".into(), v.to_string()));
        }
        if let Some(v) = &self.selected_ad_account_id {
            q.push(("selectedAdAccountId".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::get_google_integration`].
#[derive(Debug, Clone, Default)]
pub struct GetGoogleIntegrationParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetGoogleIntegrationParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_keyword_ideas`].
#[derive(Debug, Clone, Default)]
pub struct GetKeywordIdeasParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetKeywordIdeasParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_current_google_user`].
#[derive(Debug, Clone, Default)]
pub struct GetCurrentGoogleUserParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetCurrentGoogleUserParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_reporting_data_op`].
#[derive(Debug, Clone, Default)]
pub struct GetReportingDataOpParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Group by period
    /// Allowed values: `date`, `week`, `month`.
    pub group_by: Option<String>,
    /// Report start date
    /// Required by the API.
    pub start_date: String,
    /// Report end date
    /// Required by the API.
    pub end_date: String,
    /// Integration type
    /// Allowed values: `AD_MANAGER`, `INTEGRATION`.
    /// Required by the API.
    pub type_: String,
    /// Comma-separated reporting fields
    /// Required by the API.
    pub fields: String,
}

impl GetReportingDataOpParams {
    /// Start from the parameters the API requires.
    pub fn new(
        location_id: impl Into<String>,
        start_date: impl Into<String>,
        end_date: impl Into<String>,
        type_: impl Into<String>,
        fields: impl Into<String>,
    ) -> Self {
        Self {
            location_id: location_id.into(),
            start_date: start_date.into(),
            end_date: end_date.into(),
            type_: type_.into(),
            fields: fields.into(),
            ..Default::default()
        }
    }

    /// Group by period
    pub fn group_by(mut self, v: impl Into<String>) -> Self {
        self.group_by = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("startDate".into(), self.start_date.clone()),
            ("endDate".into(), self.end_date.clone()),
            ("type".into(), self.type_.clone()),
            ("fields".into(), self.fields.clone()),
        ];
        if let Some(v) = &self.group_by {
            q.push(("groupBy".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::get_campaign_reporting_op`].
#[derive(Debug, Clone, Default)]
pub struct GetCampaignReportingOpParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Report start date
    /// Required by the API.
    pub start_date: String,
    /// Report end date
    /// Required by the API.
    pub end_date: String,
}

impl GetCampaignReportingOpParams {
    /// Start from the parameters the API requires.
    pub fn new(
        location_id: impl Into<String>,
        start_date: impl Into<String>,
        end_date: impl Into<String>,
    ) -> Self {
        Self {
            location_id: location_id.into(),
            start_date: start_date.into(),
            end_date: end_date.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("startDate".into(), self.start_date.clone()),
            ("endDate".into(), self.end_date.clone()),
        ];
        q
    }
}

/// Query parameters for [`AdManagerService::get_reporting_list_op`].
#[derive(Debug, Clone, Default)]
pub struct GetReportingListOpParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Report list type
    /// Required by the API.
    pub list_type: String,
    /// Report start date
    /// Required by the API.
    pub start_date: String,
    /// Report end date
    /// Required by the API.
    pub end_date: String,
    /// Campaign identifier
    pub campaign_id: Option<String>,
    /// Integration type
    /// Allowed values: `AD_MANAGER`, `INTEGRATION`.
    /// Required by the API.
    pub type_: String,
}

impl GetReportingListOpParams {
    /// Start from the parameters the API requires.
    pub fn new(
        location_id: impl Into<String>,
        list_type: impl Into<String>,
        start_date: impl Into<String>,
        end_date: impl Into<String>,
        type_: impl Into<String>,
    ) -> Self {
        Self {
            location_id: location_id.into(),
            list_type: list_type.into(),
            start_date: start_date.into(),
            end_date: end_date.into(),
            type_: type_.into(),
            ..Default::default()
        }
    }

    /// Campaign identifier
    pub fn campaign_id(mut self, v: impl Into<String>) -> Self {
        self.campaign_id = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("listType".into(), self.list_type.clone()),
            ("startDate".into(), self.start_date.clone()),
            ("endDate".into(), self.end_date.clone()),
            ("type".into(), self.type_.clone()),
        ];
        if let Some(v) = &self.campaign_id {
            q.push(("campaignId".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::get_segments`].
#[derive(Debug, Clone, Default)]
pub struct GetSegmentsParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Segment type
    pub type_: Option<String>,
}

impl GetSegmentsParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            ..Default::default()
        }
    }

    /// Segment type
    pub fn type_(mut self, v: impl Into<String>) -> Self {
        self.type_ = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        if let Some(v) = &self.type_ {
            q.push(("type".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::upsert_segment`].
#[derive(Debug, Clone, Default)]
pub struct UpsertSegmentParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Segment type
    /// Allowed values: `CUSTOM_SEGMENTS`, `WEBSITE_VISITOR`, `CUSTOMER_MATCH`, `LOOKALIKE`.
    /// Required by the API.
    pub type_: String,
}

impl UpsertSegmentParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>, type_: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            type_: type_.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("type".into(), self.type_.clone()),
        ];
        q
    }
}

/// Query parameters for [`AdManagerService::delete_segment`].
#[derive(Debug, Clone, Default)]
pub struct DeleteSegmentParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Segment type
    /// Allowed values: `CUSTOM_SEGMENTS`, `DATA_SEGMENTS`.
    /// Required by the API.
    pub type_: String,
}

impl DeleteSegmentParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>, type_: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            type_: type_.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("type".into(), self.type_.clone()),
        ];
        q
    }
}

/// Query parameters for [`AdManagerService::get_segment_by_id`].
#[derive(Debug, Clone, Default)]
pub struct GetSegmentByIdParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Segment type
    /// Allowed values: `CUSTOM_SEGMENTS`, `DATA_SEGMENTS`.
    /// Required by the API.
    pub type_: String,
}

impl GetSegmentByIdParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>, type_: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            type_: type_.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("type".into(), self.type_.clone()),
        ];
        q
    }
}

/// Query parameters for [`AdManagerService::get_target_interests`].
#[derive(Debug, Clone, Default)]
pub struct GetTargetInterestsParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Interest type
    /// Allowed values: `AFFINITY`, `IN_MARKET`.
    /// Required by the API.
    pub type_: String,
    /// Channel type
    /// Required by the API.
    pub advertising_channel_type: String,
}

impl GetTargetInterestsParams {
    /// Start from the parameters the API requires.
    pub fn new(
        location_id: impl Into<String>,
        type_: impl Into<String>,
        advertising_channel_type: impl Into<String>,
    ) -> Self {
        Self {
            location_id: location_id.into(),
            type_: type_.into(),
            advertising_channel_type: advertising_channel_type.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("type".into(), self.type_.clone()),
            (
                "advertisingChannelType".into(),
                self.advertising_channel_type.clone(),
            ),
        ];
        q
    }
}

/// Query parameters for [`AdManagerService::search_targeting_options_op`].
#[derive(Debug, Clone, Default)]
pub struct SearchTargetingOptionsOpParams {
    /// Search type
    /// Required by the API.
    pub type_: String,
    /// Search query
    pub query: Option<String>,
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl SearchTargetingOptionsOpParams {
    /// Start from the parameters the API requires.
    pub fn new(type_: impl Into<String>, location_id: impl Into<String>) -> Self {
        Self {
            type_: type_.into(),
            location_id: location_id.into(),
            ..Default::default()
        }
    }

    /// Search query
    pub fn query(mut self, v: impl Into<String>) -> Self {
        self.query = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![
            ("type".into(), self.type_.clone()),
            ("locationId".into(), self.location_id.clone()),
        ];
        if let Some(v) = &self.query {
            q.push(("query".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::delete_ad_account_op2`].
#[derive(Debug, Clone, Default)]
pub struct DeleteAdAccountOp2Params {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Ad account identifier
    /// Required by the API.
    pub ad_account_id: String,
}

impl DeleteAdAccountOp2Params {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>, ad_account_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            ad_account_id: ad_account_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("adAccountId".into(), self.ad_account_id.clone()),
        ];
        q
    }
}

/// Query parameters for [`AdManagerService::get_ad_account_details_op2`].
#[derive(Debug, Clone, Default)]
pub struct GetAdAccountDetailsOp2Params {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Ad account identifier
    /// Required by the API.
    pub ad_account_id: String,
}

impl GetAdAccountDetailsOp2Params {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>, ad_account_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            ad_account_id: ad_account_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("adAccountId".into(), self.ad_account_id.clone()),
        ];
        q
    }
}

/// Query parameters for [`AdManagerService::get_linked_in_ad_accounts`].
#[derive(Debug, Clone, Default)]
pub struct GetLinkedInAdAccountsParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetLinkedInAdAccountsParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_ad_campaign_group`].
#[derive(Debug, Clone, Default)]
pub struct GetAdCampaignGroupParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetAdCampaignGroupParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_linked_in_integration`].
#[derive(Debug, Clone, Default)]
pub struct GetLinkedInIntegrationParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetLinkedInIntegrationParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_current_linked_in_user`].
#[derive(Debug, Clone, Default)]
pub struct GetCurrentLinkedInUserParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetCurrentLinkedInUserParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_ad_analytics`].
#[derive(Debug, Clone, Default)]
pub struct GetAdAnalyticsParams {
    /// Location ID
    /// Required by the API.
    pub location_id: String,
    /// Analytics pivot type
    /// Allowed values: `ACCOUNT`, `CAMPAIGN`, `CAMPAIGN_GROUP`, `CREATIVE`.
    pub pivot: Option<String>,
    /// Time granularity for analytics
    /// Allowed values: `day`, `month`, `year`.
    pub group_by: Option<String>,
    /// Start date in yyyy-mm-dd format
    /// Required by the API.
    pub start_date: String,
    /// End date in yyyy-mm-dd format
    /// Required by the API.
    pub end_date: String,
    /// Comma-separated list of entity URNs
    pub entity_urns: Option<String>,
    /// Comma-separated list of fields to retrieve
    pub fields: Option<String>,
}

impl GetAdAnalyticsParams {
    /// Start from the parameters the API requires.
    pub fn new(
        location_id: impl Into<String>,
        start_date: impl Into<String>,
        end_date: impl Into<String>,
    ) -> Self {
        Self {
            location_id: location_id.into(),
            start_date: start_date.into(),
            end_date: end_date.into(),
            ..Default::default()
        }
    }

    /// Analytics pivot type
    pub fn pivot(mut self, v: impl Into<String>) -> Self {
        self.pivot = Some(v.into());
        self
    }

    /// Time granularity for analytics
    pub fn group_by(mut self, v: impl Into<String>) -> Self {
        self.group_by = Some(v.into());
        self
    }

    /// Comma-separated list of entity URNs
    pub fn entity_urns(mut self, v: impl Into<String>) -> Self {
        self.entity_urns = Some(v.into());
        self
    }

    /// Comma-separated list of fields to retrieve
    pub fn fields(mut self, v: impl Into<String>) -> Self {
        self.fields = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("startDate".into(), self.start_date.clone()),
            ("endDate".into(), self.end_date.clone()),
        ];
        if let Some(v) = &self.pivot {
            q.push(("pivot".into(), v.to_string()));
        }
        if let Some(v) = &self.group_by {
            q.push(("groupBy".into(), v.to_string()));
        }
        if let Some(v) = &self.entity_urns {
            q.push(("entityUrns".into(), v.to_string()));
        }
        if let Some(v) = &self.fields {
            q.push(("fields".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::get_campaign_group_reporting`].
#[derive(Debug, Clone, Default)]
pub struct GetCampaignGroupReportingParams {
    /// Location ID
    /// Required by the API.
    pub location_id: String,
    /// Start date in yyyy-mm-dd format
    /// Required by the API.
    pub start_date: String,
    /// End date in yyyy-mm-dd format
    /// Required by the API.
    pub end_date: String,
    /// Comma-separated list of fields to retrieve
    pub fields: Option<String>,
    /// Campaign group ID
    pub campaign_group_id: Option<String>,
}

impl GetCampaignGroupReportingParams {
    /// Start from the parameters the API requires.
    pub fn new(
        location_id: impl Into<String>,
        start_date: impl Into<String>,
        end_date: impl Into<String>,
    ) -> Self {
        Self {
            location_id: location_id.into(),
            start_date: start_date.into(),
            end_date: end_date.into(),
            ..Default::default()
        }
    }

    /// Comma-separated list of fields to retrieve
    pub fn fields(mut self, v: impl Into<String>) -> Self {
        self.fields = Some(v.into());
        self
    }

    /// Campaign group ID
    pub fn campaign_group_id(mut self, v: impl Into<String>) -> Self {
        self.campaign_group_id = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("startDate".into(), self.start_date.clone()),
            ("endDate".into(), self.end_date.clone()),
        ];
        if let Some(v) = &self.fields {
            q.push(("fields".into(), v.to_string()));
        }
        if let Some(v) = &self.campaign_group_id {
            q.push(("campaignGroupId".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::get_reporting_list_op2`].
#[derive(Debug, Clone, Default)]
pub struct GetReportingListOp2Params {
    /// Location ID
    /// Required by the API.
    pub location_id: String,
    /// List type
    /// Required by the API.
    pub list_type: String,
    /// Campaign ID
    /// Required by the API.
    pub campaign_id: String,
    /// Campaign group ID
    /// Required by the API.
    pub campaign_group_id: String,
    /// Start date in yyyy-mm-dd format
    /// Required by the API.
    pub start_date: String,
    /// End date in yyyy-mm-dd format
    /// Required by the API.
    pub end_date: String,
    /// Comma-separated list of fields to retrieve
    pub fields: Option<String>,
}

impl GetReportingListOp2Params {
    /// Start from the parameters the API requires.
    pub fn new(
        location_id: impl Into<String>,
        list_type: impl Into<String>,
        campaign_id: impl Into<String>,
        campaign_group_id: impl Into<String>,
        start_date: impl Into<String>,
        end_date: impl Into<String>,
    ) -> Self {
        Self {
            location_id: location_id.into(),
            list_type: list_type.into(),
            campaign_id: campaign_id.into(),
            campaign_group_id: campaign_group_id.into(),
            start_date: start_date.into(),
            end_date: end_date.into(),
            ..Default::default()
        }
    }

    /// Comma-separated list of fields to retrieve
    pub fn fields(mut self, v: impl Into<String>) -> Self {
        self.fields = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("listType".into(), self.list_type.clone()),
            ("campaignId".into(), self.campaign_id.clone()),
            ("campaignGroupId".into(), self.campaign_group_id.clone()),
            ("startDate".into(), self.start_date.clone()),
            ("endDate".into(), self.end_date.clone()),
        ];
        if let Some(v) = &self.fields {
            q.push(("fields".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::search_targeting_options_op2`].
#[derive(Debug, Clone, Default)]
pub struct SearchTargetingOptionsOp2Params {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
    /// Targeting facet
    /// Required by the API.
    pub facet: String,
    /// Search query
    pub query: Option<String>,
    /// Query parameter
    pub q: Option<String>,
}

impl SearchTargetingOptionsOp2Params {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>, facet: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
            facet: facet.into(),
            ..Default::default()
        }
    }

    /// Search query
    pub fn query(mut self, v: impl Into<String>) -> Self {
        self.query = Some(v.into());
        self
    }

    /// Query parameter
    pub fn q(mut self, v: impl Into<String>) -> Self {
        self.q = Some(v.into());
        self
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let mut q: Vec<(String, String)> = vec![
            ("locationId".into(), self.location_id.clone()),
            ("facet".into(), self.facet.clone()),
        ];
        if let Some(v) = &self.query {
            q.push(("query".into(), v.to_string()));
        }
        if let Some(v) = &self.q {
            q.push(("q".into(), v.to_string()));
        }
        q
    }
}

/// Query parameters for [`AdManagerService::create_lead_form`].
#[derive(Debug, Clone, Default)]
pub struct CreateLeadFormParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl CreateLeadFormParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::get_lead_forms`].
#[derive(Debug, Clone, Default)]
pub struct GetLeadFormsParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl GetLeadFormsParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

/// Query parameters for [`AdManagerService::update_ad_status`].
#[derive(Debug, Clone, Default)]
pub struct UpdateAdStatusParams {
    /// Location identifier
    /// Required by the API.
    pub location_id: String,
}

impl UpdateAdStatusParams {
    /// Start from the parameters the API requires.
    pub fn new(location_id: impl Into<String>) -> Self {
        Self {
            location_id: location_id.into(),
        }
    }

    fn to_query(&self) -> Vec<(String, String)> {
        let q: Vec<(String, String)> = vec![("locationId".into(), self.location_id.clone())];
        q
    }
}

impl AdManagerService {
    /// Get ad accounts
    ///
    /// Retrieve Facebook ad accounts available for the connected user
    ///
    /// `GET /ad-publishing/facebook/ad-accounts`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_ad_accounts(&self, params: &GetAdAccountsParams) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/facebook/ad-accounts",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Delete ad account
    ///
    /// Remove a Facebook ad account connection from a location
    ///
    /// `DELETE /ad-publishing/facebook/ad-accounts/{adAccountId}`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn delete_ad_account(
        &self,
        ad_account_id: &str,
        body: &models::LocationIdBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/ad-accounts/{}",
            crate::services::encode(ad_account_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::DELETE,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get ad account details
    ///
    /// Retrieve details of a specific Facebook ad account
    ///
    /// `GET /ad-publishing/facebook/ad-accounts/{adAccountId}`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_ad_account_details(
        &self,
        ad_account_id: &str,
        params: &GetAdAccountDetailsParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/ad-accounts/{}",
            crate::services::encode(ad_account_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Upsert ad
    ///
    /// Create or update a Facebook ad (v2)
    ///
    /// `PUT /ad-publishing/facebook/ads-v2`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn upsert_ad(&self, body: &models::UpsertAdDTO) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::PUT,
                "/ad-publishing/facebook/ads-v2",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Delete ad
    ///
    /// Delete a Facebook ad by ID
    ///
    /// `DELETE /ad-publishing/facebook/ads/{adId}`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn delete_ad(
        &self,
        ad_id: &str,
        body: &models::LocationIdBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/ads/{}",
            crate::services::encode(ad_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::DELETE,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Duplicate ad
    ///
    /// Duplicate an existing Facebook ad
    ///
    /// `POST /ad-publishing/facebook/ads/{adId}/duplicate`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn duplicate_ad(&self, ad_id: &str) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/ads/{}/duplicate",
            crate::services::encode(ad_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Pause ad
    ///
    /// Pause a running Facebook ad
    ///
    /// `POST /ad-publishing/facebook/ads/{adId}/pause`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn pause_ad(
        &self,
        ad_id: &str,
        body: &models::LocationIdBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/ads/{}/pause",
            crate::services::encode(ad_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Resume ad
    ///
    /// Resume a paused Facebook ad
    ///
    /// `POST /ad-publishing/facebook/ads/{adId}/resume`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn resume_ad(
        &self,
        ad_id: &str,
        body: &models::LocationIdBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/ads/{}/resume",
            crate::services::encode(ad_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Upsert adset
    ///
    /// Create or update a Facebook ad set
    ///
    /// `PUT /ad-publishing/facebook/adsets`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn upsert_adset(&self, body: &models::UpsertAdsetDTO) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::PUT,
                "/ad-publishing/facebook/adsets",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Delete ad set
    ///
    /// Delete a Facebook ad set by ID
    ///
    /// `DELETE /ad-publishing/facebook/adsets/{adsetId}`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn delete_ad_set(
        &self,
        adset_id: &str,
        body: &models::LocationIdBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/adsets/{}",
            crate::services::encode(adset_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::DELETE,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Duplicate ad set
    ///
    /// Duplicate an existing Facebook ad set
    ///
    /// `POST /ad-publishing/facebook/adsets/{adsetId}/duplicate`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn duplicate_ad_set(&self, adset_id: &str) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/adsets/{}/duplicate",
            crate::services::encode(adset_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Pause ad set
    ///
    /// Pause a running Facebook ad set
    ///
    /// `POST /ad-publishing/facebook/adsets/{adsetId}/pause`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn pause_ad_set(
        &self,
        adset_id: &str,
        body: &models::LocationIdBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/adsets/{}/pause",
            crate::services::encode(adset_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Resume ad set
    ///
    /// Resume a paused Facebook ad set
    ///
    /// `POST /ad-publishing/facebook/adsets/{adsetId}/resume`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn resume_ad_set(
        &self,
        adset_id: &str,
        body: &models::LocationIdBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/adsets/{}/resume",
            crate::services::encode(adset_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get campaign with linked entities
    ///
    /// Retrieve a Facebook campaign with its linked adsets and ads
    ///
    /// `GET /ad-publishing/facebook/campaign/{campaignId}`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_campaign_with_linked_entities(
        &self,
        campaign_id: &str,
        params: &GetCampaignWithLinkedEntitiesParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/campaign/{}",
            crate::services::encode(campaign_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Upsert campaign
    ///
    /// Create or update a Facebook campaign
    ///
    /// `PUT /ad-publishing/facebook/campaigns`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn upsert_campaign(
        &self,
        body: &models::UpsertCampaignDTO,
    ) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::PUT,
                "/ad-publishing/facebook/campaigns",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Delete campaign
    ///
    /// Delete a Facebook campaign by ID
    ///
    /// `DELETE /ad-publishing/facebook/campaigns/{campaignId}`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn delete_campaign(
        &self,
        campaign_id: &str,
        body: &models::LocationIdBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/campaigns/{}",
            crate::services::encode(campaign_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::DELETE,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Duplicate campaign
    ///
    /// Duplicate an existing Facebook campaign
    ///
    /// `POST /ad-publishing/facebook/campaigns/{campaignId}/duplicate`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn duplicate_campaign(
        &self,
        campaign_id: &str,
        body: &models::LocationIdBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/campaigns/{}/duplicate",
            crate::services::encode(campaign_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Pause campaign
    ///
    /// Pause a running Facebook campaign
    ///
    /// `POST /ad-publishing/facebook/campaigns/{campaignId}/pause`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn pause_campaign(
        &self,
        campaign_id: &str,
        body: &models::LocationIdBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/campaigns/{}/pause",
            crate::services::encode(campaign_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Publish campaign
    ///
    /// Publish a Facebook campaign and push it live to Facebook
    ///
    /// `POST /ad-publishing/facebook/campaigns/{campaignId}/publish`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn publish_campaign(
        &self,
        campaign_id: &str,
        body: &models::PublishAdDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/campaigns/{}/publish",
            crate::services::encode(campaign_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Resume campaign
    ///
    /// Resume a paused Facebook campaign
    ///
    /// `POST /ad-publishing/facebook/campaigns/{campaignId}/resume`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn resume_campaign(
        &self,
        campaign_id: &str,
        body: &models::LocationIdBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/campaigns/{}/resume",
            crate::services::encode(campaign_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get conversation forms
    ///
    /// Retrieve Facebook conversation lead forms for a location
    ///
    /// `GET /ad-publishing/facebook/conversation-forms`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_conversation_forms(
        &self,
        params: &GetConversationFormsParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/facebook/conversation-forms",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Create conversation form
    ///
    /// Create a new Facebook conversation lead form
    ///
    /// `POST /ad-publishing/facebook/conversation-forms`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn create_conversation_form(
        &self,
        body: &models::CreateConversationFormDTO,
    ) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                "/ad-publishing/facebook/conversation-forms",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get custom audiences
    ///
    /// Retrieve Facebook custom audiences for a location
    ///
    /// `GET /ad-publishing/facebook/custom-audience`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_custom_audiences(
        &self,
        params: &GetCustomAudiencesParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/facebook/custom-audience",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Delete custom audience
    ///
    /// Delete a Facebook custom audience by ID
    ///
    /// `DELETE /ad-publishing/facebook/custom-audience/{audienceId}`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn delete_custom_audience(
        &self,
        audience_id: &str,
        params: &DeleteCustomAudienceParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/custom-audience/{}",
            crate::services::encode(audience_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::DELETE,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get custom audience by ID
    ///
    /// Retrieve a specific Facebook custom audience by its ID
    ///
    /// `GET /ad-publishing/facebook/custom-audience/{audienceId}`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_custom_audience_by_id(
        &self,
        audience_id: &str,
        params: &GetCustomAudienceByIdParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/custom-audience/{}",
            crate::services::encode(audience_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Update custom audience
    ///
    /// Update name or description of a Facebook custom audience
    ///
    /// `PUT /ad-publishing/facebook/custom-audience/{audienceId}`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn update_custom_audience(
        &self,
        audience_id: &str,
        body: &models::FbUpdateAudienceBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/custom-audience/{}",
            crate::services::encode(audience_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::PUT,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Remove custom audience member
    ///
    /// Remove a member from a Facebook custom audience
    ///
    /// `DELETE /ad-publishing/facebook/custom-audience/{audienceId}/member`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn remove_custom_audience_member(
        &self,
        audience_id: &str,
        body: &models::UpdateCustomAudienceDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/custom-audience/{}/member",
            crate::services::encode(audience_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::DELETE,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Add custom audience member
    ///
    /// Add a member to a Facebook custom audience
    ///
    /// `PUT /ad-publishing/facebook/custom-audience/{audienceId}/member`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn add_custom_audience_member(
        &self,
        audience_id: &str,
        body: &models::UpdateCustomAudienceDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/custom-audience/{}/member",
            crate::services::encode(audience_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::PUT,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Batch update audience members
    ///
    /// Add or remove members in bulk from a Facebook custom audience via CSV or smart lists
    ///
    /// `PUT /ad-publishing/facebook/custom-audience/{audienceId}/member/batch`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn batch_update_audience_members(
        &self,
        audience_id: &str,
        body: &models::UpdateCustomAudienceBatchDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/custom-audience/{}/member/batch",
            crate::services::encode(audience_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::PUT,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get entities
    ///
    /// Retrieve Facebook campaigns, adsets, or ads based on entity type
    ///
    /// `GET /ad-publishing/facebook/entity`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_entities(&self, params: &GetEntitiesParams) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/facebook/entity",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Delete Facebook integration
    ///
    /// Remove the Facebook ad integration from a location
    ///
    /// `DELETE /ad-publishing/facebook/integration`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn delete_facebook_integration(
        &self,
        body: &models::LocationIdBodyDTO,
    ) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::DELETE,
                "/ad-publishing/facebook/integration",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get Facebook integration
    ///
    /// Retrieve the Facebook ad integration details for a location
    ///
    /// `GET /ad-publishing/facebook/integration`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_facebook_integration(
        &self,
        params: &GetFacebookIntegrationParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/facebook/integration",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Create Facebook integration
    ///
    /// Create a Facebook ad integration for a location with page and ad account
    ///
    /// `POST /ad-publishing/facebook/integration`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn create_facebook_integration(
        &self,
        body: &models::CreateIntegrationDTO,
    ) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                "/ad-publishing/facebook/integration",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get lead form by ID
    ///
    /// Retrieve a specific Facebook lead form by its ID
    ///
    /// `GET /ad-publishing/facebook/lead-form/{leadFormId}`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_lead_form_by_id(
        &self,
        lead_form_id: &str,
        params: &GetLeadFormByIdParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/lead-form/{}",
            crate::services::encode(lead_form_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get current Facebook user
    ///
    /// Retrieve the authenticated Facebook user profile for a location
    ///
    /// `GET /ad-publishing/facebook/me`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_current_facebook_user(
        &self,
        params: &GetCurrentFacebookUserParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/facebook/me",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Delete page connection
    ///
    /// Remove a Facebook page connection from a location
    ///
    /// `DELETE /ad-publishing/facebook/page`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn delete_page_connection(
        &self,
        params: &DeletePageConnectionParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::DELETE,
                "/ad-publishing/facebook/page",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Set default page
    ///
    /// Set the default Facebook page for a location
    ///
    /// `PUT /ad-publishing/facebook/page/default`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn set_default_page(
        &self,
        params: &SetDefaultPageParams,
        body: &models::FbSetDefaultPageBodyDTO,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::PUT,
                "/ad-publishing/facebook/page/default",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get page lead forms
    ///
    /// Retrieve lead gen forms for a specific Facebook page
    ///
    /// `GET /ad-publishing/facebook/page/{pageId}/forms`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_page_lead_forms(
        &self,
        page_id: &str,
        params: &GetPageLeadFormsParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/page/{}/forms",
            crate::services::encode(page_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Create page lead form
    ///
    /// Create a new lead gen form on a Facebook page
    ///
    /// `POST /ad-publishing/facebook/page/{pageId}/forms`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn create_page_lead_form(
        &self,
        page_id: &str,
        body: &models::CreateLeadFormDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/page/{}/forms",
            crate::services::encode(page_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get Instagram accounts for page
    ///
    /// Retrieve Instagram accounts linked to a specific Facebook page
    ///
    /// `GET /ad-publishing/facebook/page/{pageId}/instagram`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_instagram_accounts_for_page(
        &self,
        page_id: &str,
        params: &GetInstagramAccountsForPageParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/page/{}/instagram",
            crate::services::encode(page_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get Facebook pages
    ///
    /// Retrieve Facebook pages associated with the connected account
    ///
    /// `GET /ad-publishing/facebook/pages`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_facebook_pages(
        &self,
        params: &GetFacebookPagesParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/facebook/pages",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get conversion pixels
    ///
    /// Retrieve Facebook conversion pixels for a location
    ///
    /// `GET /ad-publishing/facebook/pixels`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_conversion_pixels(
        &self,
        params: &GetConversionPixelsParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/facebook/pixels",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Upsert conversion pixel
    ///
    /// Create or update a Facebook conversion pixel configuration
    ///
    /// `PUT /ad-publishing/facebook/pixels`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn upsert_conversion_pixel(
        &self,
        body: &models::UpsertConversionPixelDTO,
    ) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::PUT,
                "/ad-publishing/facebook/pixels",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get reporting data
    ///
    /// Retrieve aggregated Facebook ad reporting metrics for a location
    ///
    /// `GET /ad-publishing/facebook/reporting`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_reporting_data(
        &self,
        params: &GetReportingDataParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/facebook/reporting",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get campaign reporting
    ///
    /// Retrieve reporting metrics for a specific Facebook campaign
    ///
    /// `GET /ad-publishing/facebook/reporting/campaign/{campaignId}`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_campaign_reporting(
        &self,
        campaign_id: &str,
        params: &GetCampaignReportingParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/facebook/reporting/campaign/{}",
            crate::services::encode(campaign_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get reporting list
    ///
    /// Retrieve a list of Facebook campaigns, adsets, or ads with reporting data
    ///
    /// `GET /ad-publishing/facebook/reporting/list`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_reporting_list(
        &self,
        params: &GetReportingListParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/facebook/reporting/list",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Search targeting options
    ///
    /// Search Facebook geo-locations and interests for ad targeting
    ///
    /// `GET /ad-publishing/facebook/targeting/search`
    pub async fn search_targeting_options(
        &self,
        params: &SearchTargetingOptionsParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/facebook/targeting/search",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get Google ad accounts
    ///
    /// Retrieve Google Ads accounts available for the connected user
    ///
    /// `GET /ad-publishing/google/ad-accounts`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_google_ad_accounts(
        &self,
        params: &GetGoogleAdAccountsParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/google/ad-accounts",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Delete ad account
    ///
    /// Remove a Google Ads account connection from a location
    ///
    /// `DELETE /ad-publishing/google/ad-accounts/{adAccountId}`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn delete_ad_account_op(
        &self,
        ad_account_id: &str,
        body: &models::LocationIdBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/google/ad-accounts/{}",
            crate::services::encode(ad_account_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::DELETE,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get ad account details
    ///
    /// Retrieve details of a specific Google Ads account
    ///
    /// `GET /ad-publishing/google/ad-accounts/{adAccountId}`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_ad_account_details_op(
        &self,
        ad_account_id: &str,
        params: &GetAdAccountDetailsOpParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/google/ad-accounts/{}",
            crate::services::encode(ad_account_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Upsert Google campaign
    ///
    /// Create or update a full Google Ads campaign structure
    ///
    /// `PUT /ad-publishing/google/ads`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn upsert_google_campaign(
        &self,
        body: &models::CampaignDTO,
    ) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::PUT,
                "/ad-publishing/google/ads",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get Google campaign by ID
    ///
    /// Retrieve a specific Google Ads campaign by ID
    ///
    /// `GET /ad-publishing/google/ads/{adId}`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_google_campaign_by_id(
        &self,
        ad_id: &str,
        params: &GetGoogleCampaignByIdParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/google/ads/{}",
            crate::services::encode(ad_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Publish ad
    ///
    /// Publish a Google ad and push it live
    ///
    /// `POST /ad-publishing/google/ads/{adId}/publish`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn publish_ad(&self, ad_id: &str) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/google/ads/{}/publish",
            crate::services::encode(ad_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get assets
    ///
    /// Retrieve Google Ads creative assets for a location
    ///
    /// `GET /ad-publishing/google/assets`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_assets(&self, params: &GetAssetsParams) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/google/assets",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Upsert assets
    ///
    /// Create or update Google Ads creative assets
    ///
    /// `POST /ad-publishing/google/assets`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn upsert_assets(&self, body: &models::UpsertAssetsDTO) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                "/ad-publishing/google/assets",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get audiences
    ///
    /// Retrieve Google Ads combined audiences for a location
    ///
    /// `GET /ad-publishing/google/audiences`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_audiences(&self, params: &GetAudiencesParams) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/google/audiences",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Upsert audience
    ///
    /// Create or update a Google Ads combined audience
    ///
    /// `PUT /ad-publishing/google/audiences`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn upsert_audience(
        &self,
        body: &models::UpsertAudienceDTO,
    ) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::PUT,
                "/ad-publishing/google/audiences",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get audience by ID
    ///
    /// Retrieve a specific Google Ads combined audience by ID
    ///
    /// `GET /ad-publishing/google/audiences/{audienceId}`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_audience_by_id(
        &self,
        audience_id: &str,
        params: &GetAudienceByIdParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/google/audiences/{}",
            crate::services::encode(audience_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get conversion goals
    ///
    /// Retrieve Google Ads conversion goals for a location
    ///
    /// `GET /ad-publishing/google/conversion-goals`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_conversion_goals(
        &self,
        params: &GetConversionGoalsParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/google/conversion-goals",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get conversions
    ///
    /// Retrieve Google Ads conversion actions for a location
    ///
    /// `GET /ad-publishing/google/conversions`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_conversions(
        &self,
        params: &GetConversionsParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/google/conversions",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Upsert conversion
    ///
    /// Create or update a Google Ads conversion action
    ///
    /// `PUT /ad-publishing/google/conversions`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn upsert_conversion(
        &self,
        body: &models::UpsertConversionDTO,
    ) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::PUT,
                "/ad-publishing/google/conversions",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Delete conversion
    ///
    /// Delete a Google Ads conversion action by ID
    ///
    /// `DELETE /ad-publishing/google/conversions/{conversionId}`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn delete_conversion(
        &self,
        conversion_id: &str,
        params: &DeleteConversionParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/google/conversions/{}",
            crate::services::encode(conversion_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::DELETE,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get conversion by ID
    ///
    /// Retrieve a specific Google Ads conversion action by ID
    ///
    /// `GET /ad-publishing/google/conversions/{conversionId}`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_conversion_by_id(
        &self,
        conversion_id: &str,
        params: &GetConversionByIdParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/google/conversions/{}",
            crate::services::encode(conversion_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get entities
    ///
    /// Retrieve Google campaigns, ad groups, or ads based on entity type
    ///
    /// `GET /ad-publishing/google/entity`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_entities_op(&self, params: &GetEntitiesOpParams) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/google/entity",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get Google integration
    ///
    /// Retrieve the Google Ads integration details for a location
    ///
    /// `GET /ad-publishing/google/integration`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_google_integration(
        &self,
        params: &GetGoogleIntegrationParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/google/integration",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Create Google integration
    ///
    /// Create a Google Ads integration for a location
    ///
    /// `POST /ad-publishing/google/integration`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn create_google_integration(
        &self,
        body: &models::CreateGoogleIntegrationDTO,
    ) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                "/ad-publishing/google/integration",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get keyword ideas
    ///
    /// Retrieve keyword suggestions for Google Ads campaigns
    ///
    /// `POST /ad-publishing/google/keyword-ideas`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_keyword_ideas(
        &self,
        params: &GetKeywordIdeasParams,
        body: &models::KeywordSuggestionDTO,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                "/ad-publishing/google/keyword-ideas",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get current Google user
    ///
    /// Retrieve the authenticated Google user info for a location
    ///
    /// `GET /ad-publishing/google/me`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_current_google_user(
        &self,
        params: &GetCurrentGoogleUserParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/google/me",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get reporting data
    ///
    /// Retrieve aggregated Google Ads reporting metrics for a location
    ///
    /// `GET /ad-publishing/google/reporting`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_reporting_data_op(
        &self,
        params: &GetReportingDataOpParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/google/reporting",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get campaign reporting
    ///
    /// Retrieve reporting metrics for a specific Google campaign
    ///
    /// `GET /ad-publishing/google/reporting/campaign/{campaignId}`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_campaign_reporting_op(
        &self,
        campaign_id: &str,
        params: &GetCampaignReportingOpParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/google/reporting/campaign/{}",
            crate::services::encode(campaign_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get reporting list
    ///
    /// Retrieve a list of Google campaigns or ad groups with reporting data
    ///
    /// `GET /ad-publishing/google/reporting/list`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_reporting_list_op(
        &self,
        params: &GetReportingListOpParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/google/reporting/list",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get segments
    ///
    /// Retrieve Google Ads audience segments for a location
    ///
    /// `GET /ad-publishing/google/segments`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_segments(&self, params: &GetSegmentsParams) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/google/segments",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Upsert segment
    ///
    /// Create or update a Google Ads audience segment
    ///
    /// `PUT /ad-publishing/google/segments`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn upsert_segment(
        &self,
        params: &UpsertSegmentParams,
        body: &models::UpsertSegmentDTO,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::PUT,
                "/ad-publishing/google/segments",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Create offline user list job
    ///
    /// Create a job to upload users to a Google customer match list
    ///
    /// `POST /ad-publishing/google/segments/offline-user-list-job`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn create_offline_user_list_job(
        &self,
        body: &models::CreateOfflineUserListJobDTO,
    ) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                "/ad-publishing/google/segments/offline-user-list-job",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Delete segment
    ///
    /// Delete a Google Ads audience segment by ID
    ///
    /// `DELETE /ad-publishing/google/segments/{segmentId}`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn delete_segment(
        &self,
        segment_id: &str,
        params: &DeleteSegmentParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/google/segments/{}",
            crate::services::encode(segment_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::DELETE,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get segment by ID
    ///
    /// Retrieve a specific Google Ads audience segment by ID
    ///
    /// `GET /ad-publishing/google/segments/{segmentId}`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_segment_by_id(
        &self,
        segment_id: &str,
        params: &GetSegmentByIdParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/google/segments/{}",
            crate::services::encode(segment_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get target interests
    ///
    /// Retrieve affinity and in-market audience options for Google Ads targeting
    ///
    /// `GET /ad-publishing/google/target-interests`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_target_interests(
        &self,
        params: &GetTargetInterestsParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/google/target-interests",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Search targeting options
    ///
    /// Search Google geo-locations for ad targeting
    ///
    /// `GET /ad-publishing/google/targeting/search`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn search_targeting_options_op(
        &self,
        params: &SearchTargetingOptionsOpParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/google/targeting/search",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Delete ad account
    ///
    /// Remove a LinkedIn ad account connection from a location
    ///
    /// `DELETE /ad-publishing/linkedin/ad-account`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn delete_ad_account_op2(
        &self,
        params: &DeleteAdAccountOp2Params,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::DELETE,
                "/ad-publishing/linkedin/ad-account",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get ad account details
    ///
    /// Retrieve details of a specific LinkedIn ad account
    ///
    /// `GET /ad-publishing/linkedin/ad-account`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_ad_account_details_op2(
        &self,
        params: &GetAdAccountDetailsOp2Params,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/linkedin/ad-account",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get LinkedIn ad accounts
    ///
    /// Retrieve LinkedIn Ads accounts available for the connected user
    ///
    /// `GET /ad-publishing/linkedin/ad-accounts`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_linked_in_ad_accounts(
        &self,
        params: &GetLinkedInAdAccountsParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/linkedin/ad-accounts",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Upsert ad campaign group
    ///
    /// Create or update a LinkedIn ad campaign group with campaigns and ads
    ///
    /// `PUT /ad-publishing/linkedin/ads`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn upsert_ad_campaign_group(
        &self,
        body: &models::AdCampaignGroupDataDTO,
    ) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::PUT,
                "/ad-publishing/linkedin/ads",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get ad campaign group
    ///
    /// Retrieve a LinkedIn ad campaign group by ID
    ///
    /// `GET /ad-publishing/linkedin/ads/{adId}`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_ad_campaign_group(
        &self,
        ad_id: &str,
        params: &GetAdCampaignGroupParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/linkedin/ads/{}",
            crate::services::encode(ad_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Publish ad campaign group
    ///
    /// Publish a LinkedIn ad campaign group and push it live
    ///
    /// `POST /ad-publishing/linkedin/ads/{adId}/publish`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn publish_ad_campaign_group(
        &self,
        ad_id: &str,
        body: &models::LocationIdBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/linkedin/ads/{}/publish",
            crate::services::encode(ad_id)
        );
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get LinkedIn integration
    ///
    /// Retrieve the LinkedIn Ads integration details for a location
    ///
    /// `GET /ad-publishing/linkedin/integration`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_linked_in_integration(
        &self,
        params: &GetLinkedInIntegrationParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/linkedin/integration",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Create LinkedIn integration
    ///
    /// Create a LinkedIn Ads integration for a location with ad account details
    ///
    /// `POST /ad-publishing/linkedin/integration`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn create_linked_in_integration(
        &self,
        body: &models::CreateLinkedinIntegrationDTO,
    ) -> Result<serde_json::Value> {
        let query = Vec::new();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                "/ad-publishing/linkedin/integration",
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get current LinkedIn user
    ///
    /// Retrieve the authenticated LinkedIn user info for a location
    ///
    /// `GET /ad-publishing/linkedin/me`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_current_linked_in_user(
        &self,
        params: &GetCurrentLinkedInUserParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/linkedin/me",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get ad analytics
    ///
    /// Retrieve LinkedIn Ads analytics data with configurable pivot and time grouping
    ///
    /// `GET /ad-publishing/linkedin/reporting`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_ad_analytics(
        &self,
        params: &GetAdAnalyticsParams,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/linkedin/reporting",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get campaign group reporting
    ///
    /// Retrieve reporting metrics for a specific LinkedIn campaign group
    ///
    /// `GET /ad-publishing/linkedin/reporting/campaign-group/{campaignGroupId}`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_campaign_group_reporting(
        &self,
        campaign_group_id: &str,
        params: &GetCampaignGroupReportingParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/linkedin/reporting/campaign-group/{}",
            crate::services::encode(campaign_group_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Get reporting list
    ///
    /// Retrieve a list of LinkedIn campaigns or campaign groups with reporting data
    ///
    /// `GET /ad-publishing/linkedin/reporting/list`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_reporting_list_op2(
        &self,
        params: &GetReportingListOp2Params,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/linkedin/reporting/list",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Search targeting options
    ///
    /// Search LinkedIn targeting facets such as locations, industries, and job titles
    ///
    /// `GET /ad-publishing/linkedin/targeting/search`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn search_targeting_options_op2(
        &self,
        params: &SearchTargetingOptionsOp2Params,
    ) -> Result<serde_json::Value> {
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                "/ad-publishing/linkedin/targeting/search",
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Create lead form
    ///
    /// Create a new LinkedIn lead gen form for an ad account
    ///
    /// `POST /ad-publishing/linkedin/{accountId}/form`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn create_lead_form(
        &self,
        account_id: &str,
        params: &CreateLeadFormParams,
        body: &models::LinkedInCreateLeadFormBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/linkedin/{}/form",
            crate::services::encode(account_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::POST,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }

    /// Get lead forms
    ///
    /// Retrieve LinkedIn lead gen forms for an ad account
    ///
    /// `GET /ad-publishing/linkedin/{accountId}/forms`
    ///
    /// Requires scope: `adPublishing.readonly`.
    pub async fn get_lead_forms(
        &self,
        account_id: &str,
        params: &GetLeadFormsParams,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/linkedin/{}/forms",
            crate::services::encode(account_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::GET,
                &path,
                &query,
                None::<&()>,
                Some("2021-07-28"),
            )
            .await
    }

    /// Update ad status
    ///
    /// Pause or resume a LinkedIn ad, campaign, or ad group
    ///
    /// `PATCH /ad-publishing/linkedin/{adId}/status`
    ///
    /// Requires scope: `adPublishing.write`.
    pub async fn update_ad_status(
        &self,
        ad_id: &str,
        params: &UpdateAdStatusParams,
        body: &models::LinkedInUpdateAdStatusBodyDTO,
    ) -> Result<serde_json::Value> {
        let path = format!(
            "/ad-publishing/linkedin/{}/status",
            crate::services::encode(ad_id)
        );
        let query = params.to_query();
        self.client
            .send_versioned(
                reqwest::Method::PATCH,
                &path,
                &query,
                Some(body),
                Some("2021-07-28"),
            )
            .await
    }
}