AIsa Ads
Direct已上线245 个 API按量计费更新于 1年1月1日
在你连接的广告账户上管理广告系列、广告组、广告、受众和报表，Meta、Google、TikTok、LinkedIn、Pinterest、X、Reddit 和 OpenAI（ChatGPT）广告用同一种请求格式。
调用示例
所有供应商共用一个 Key。这里调用的是 List ads。 按量计费
返回的是 AIsa Ads 自己的 JSON，原样透传。
计价方式
- 按次计费245 个 API
- 每次调用固定价格，标在每个 API 上。
API245
AIsa 为 AIsa Ads 提供的全部 API，以 api.aisa.one 当前列出的为准。点击路径可打开它在文档中的页面。
- GET
/apis/v1/adsList ads · Ad Campaigns. Read only. Lists your ads with their performance over a date range, including ads created directly in each platform's ads manager. Returns a paginated list of ads with metrics computed over an optional date range. Use source=all to include externally-synced ads from platform ad managers. If no date range is provided, it defaults to the last 90 days. The date range is capped at 730 days max. ### History按量计费 - GET
/apis/v1/ads/accountsList ad accounts · Ad Accounts. Read only. Lists the ad accounts a connection can manage, such as Meta ad accounts, TikTok advertisers or Google Ads customers. Returns the platform ad accounts available for the given account (e.g. Meta ad accounts, TikTok advertiser IDs, Google Ads customer IDs). ### Meta Meta business-login accounts use their own system-user token.按量计费 - POST
/apis/v1/ads/accountsCreate ad account · Ad Accounts. Can spend money or change spend: needs the ads:spend scope and X-Aisa-Confirm: spend; without the header the request is refused with confirmation_required and nothing is sent. Creates a new ad account. validateOnly=true checks the request without acting and needs no confirmation. Creates a new Meta ad account in the user's own business portfolio, or a Google Ads client account under a manager (MCC) account the connection reaches. Billing must then be set up on the platform. Meta (omit `platform` or send `meta`). Creates a durable Meta ad account in the end user's own business portfolio using their connected Meta Ads token. ### Meta requirements按量计费 - PATCH
/apis/v1/ads/accountsUpdate ad account settings · Ad Accounts. Can spend money or change spend: needs the ads:spend scope and X-Aisa-Confirm: spend; without the header the request is refused with confirmation_required and nothing is sent. Changes ad account settings, including its spend cap. Changes a Meta ad account's name, spend cap or default EU DSA beneficiary and payor. Pass any combination of fields. On Google Ads, only URL tracking fields apply (see below). Other platforms return 400. ### Spend cap `spendCap` is the total the account may spend before Meta pauses every campaign in it, in whole units of the account currency. `spendCap: null` removes the cap.按量计费 - GET
/apis/v1/ads/accounts/billingGet ad account billing · Ad Accounts. Read only. Reads the payments accounts a Google Ads account can be billed to, plus its billing setups and account budgets. ### Payments accounts Payments accounts come from Google's PaymentsAccountService, read as the manager above the customer. They are the monthly invoicing (consolidated billing) accounts of that manager.按量计费 - POST
/apis/v1/ads/accounts/billingSet up ad account billing (monthly invoicing) · Ad Accounts. Can spend money or change spend: needs the ads:spend scope and X-Aisa-Confirm: spend; without the header the request is refused with confirmation_required and nothing is sent. Sets up billing for the ad account, with its spending limit. validateOnly=true checks the request without acting and needs no confirmation. Bills a Google Ads account to a monthly invoicing payments account of a manager above it, and proposes its account budget, so the account can serve without anyone opening Google Ads. ### Monthly invoicing only Google's API cannot add a card or other payment method.按量计费 - GET
/apis/v1/ads/accounts/calloutsList account callouts · Ad Accounts. Read only. Lists the callouts attached at account level in Google Ads, which can show on ads across all campaigns. Fresh reads are cached for 10 minutes; exhausted quota may return the last successful read with stale=true. Inherited assets are not included. Preserves Google RMF C.75 account-level callouts.按量计费 - POST
/apis/v1/ads/accounts/calloutsAdd account callouts · Ad Accounts. Changes the ad account without starting or raising spend; audited. Creates callouts and attaches them at account level in Google Ads so they can show on ads across all campaigns. Creates assets and customer_asset links for this Google customer. Links apply at account level.按量计费 - PUT
/apis/v1/ads/accounts/calloutsUpdate account callouts · Ad Accounts. Changes the ad account without starting or raising spend; audited. Edits existing Google Ads callouts in place; the change applies everywhere that callout is used. Send updates with assetResourceName and the fields to change. An asset is shared: changes affect every attachment using it. Omitted fields stay unchanged. The operation consumes the Google operations budget and invalidates affected cached lists.按量计费 - DELETE
/apis/v1/ads/accounts/calloutsRemove account callout · Ad Accounts. Changes the ad account without starting or raising spend; audited. Detaches a callout from the Google Ads account level, leaving it on any campaigns or ad groups that still use it. Removes the customer_asset attachment only. The underlying shared asset and its campaign or ad-group attachments remain. Fields go in the query string. A JSON body with the same fields is also accepted and, when sent, the query string is ignored.按量计费 - GET
/apis/v1/ads/accounts/financeAd account finances · Ad Accounts. Read only. Shows a Meta ad account's balance, total spend, spend cap and funding source. Finances of one Meta ad account: prepaid `balance`, lifetime `amountSpent`, account `spendCap` (null = no cap) and the `fundingSource`. Money values are converted from Meta's minor units to whole units of `currency`.按量计费 - GET
/apis/v1/ads/accounts/healthCheck an ad account before creating ads · Ad Accounts. Read only. Checks whether a Meta ad account can run ads right now, with a fix link for each problem. ### What is checked the account status the payment method the account spending limit the Facebook Page and its Instagram account the Page's Lead Ads terms the newest pixel event the WhatsApp number linked to the Page按量计费 - GET
/apis/v1/ads/accounts/hierarchyGet manager account hierarchy · Ad Accounts. Read only. Shows the Google Ads manager (MCC) and client account tree for a connection, including pending invitations and link status. ### How the tree is built It starts from every customer the Google user behind the connection can access directly and walks each tree to any depth with `customer_client`.按量计费 - GET
/apis/v1/ads/accounts/liveRead an ad account's campaigns and ad sets live · Ad Accounts. Read only. Reads an ad account's campaigns and ad sets straight from Meta or TikTok, so checks like budget limits see current values. It reads one Meta ad account or TikTok advertiser live from the platform, so it is cheap enough to run before every write. For example, a per-ad-account spend ceiling that must see the current daily / lifetime budget rather than the synced copy.按量计费 - POST
/apis/v1/ads/accounts/manager-linksInvite a client account to a manager · Ad Accounts. Changes the ad account without starting or raising spend; audited. validateOnly=true checks the request without acting and needs no confirmation. Invites a Google Ads account to be managed by one of your manager accounts; the link stays pending until the client accepts. Sends a manager-to-client link invitation from `managerCustomerId` to `clientCustomerId` (Google's CustomerClientLinkService). The manager must be one the connection's Google user reaches, directly or under another manager (see GET /apis/v1/ads/accounts/hierarchy).按量计费 - PATCH
/apis/v1/ads/accounts/manager-linksAccept, decline, cancel or end a manager link · Ad Accounts. Changes the ad account without starting or raising spend; audited. validateOnly=true checks the request without acting and needs no confirmation. Accepts, declines or cancels a Google Ads manager invitation, or ends an existing manager-client link. Changes one manager-client link, identified by `managerCustomerId`, `clientCustomerId` and `managerLinkId` (all from GET /apis/v1/ads/accounts/hierarchy). ### Actions `accept` and `decline`: answer a pending invitation as the client (CustomerManagerLinkService).按量计费 - GET
/apis/v1/ads/accounts/negative-keyword-listsList negative keyword lists · Ad Accounts. Read only. Lists the shared negative keyword lists in a Google Ads account, which you can apply to many campaigns at once. Google Ads shared negative keyword lists (shared_set type NEGATIVE_KEYWORDS). Reads are cached for 10 minutes; quota exhaustion may return the last successful result for up to 7 days with stale=true. Customer selection is limited to this connection and its account scope.按量计费 - POST
/apis/v1/ads/accounts/negative-keyword-listsCreate a negative keyword list · Ad Accounts. Changes the ad account without starting or raising spend; audited. Creates a shared Google Ads negative keyword list, optionally with starting keywords; it is not attached to any campaign yet. Creates one Google Ads shared negative keyword list with optional initial keywords in a single atomic mutation. Daily quota is reserved for every mutate item, so large batches may return 429 before any change. This operation is not idempotent.按量计费 - GET
/apis/v1/ads/accounts/negative-keyword-lists/{listId}Get a negative keyword list · Ad Accounts. Read only. Shows one shared Google Ads negative keyword list with all of its keywords. Google Ads shared negative keyword lists (shared_set type NEGATIVE_KEYWORDS). Reads are cached for 10 minutes; quota exhaustion may return the last successful result for up to 7 days with stale=true. Customer selection is limited to this connection and its account scope. Includes the keywords and their criterion ids.按量计费 - PUT
/apis/v1/ads/accounts/negative-keyword-lists/{listId}Rename a negative keyword list · Ad Accounts. Changes the ad account without starting or raising spend; audited. Renames a shared Google Ads negative keyword list without changing its keywords or the campaigns using it. Keywords and campaign associations are unchanged. Use the keywords endpoint to edit the desired keyword set.按量计费