List ad groups in a Microsoft Ads campaign — bids, status
microsoft-ads.adgroupsList the ad groups in a Microsoft Advertising campaign with their bids and status
- Price
- freeZum Listenpreis
- Success rate
- —Noch keine ErfolgsratendatenNoch keine Erfolgsratendaten
- Latency p50
- ——
- Last verified
- —Not verified yet
POSThttps://toolswitch.dev/v1/tools/microsoft-ads.adgroupsBeta- Uses platform quota
- Synchronous response
- Reads public data
Parameter
returns AdGroups[] with Id, Name, Status, CpcBid/CpmBid/CpvBid (each wrapped as {"Amount": 1.5}), Network, Language, StartDate/EndDate and AdGroupType. Bid amounts are decimals in the account currency
| Parameter | Typ | Erforderlich | Beschreibung | Beispiel |
|---|---|---|---|---|
| Anfragetext (JSON) | ||||
CampaignId | Ganzzahl | Erforderlich | from Campaigns/QueryByAccountId | 987654321 |
ReturnAdditionalFields | Zeichenkette | Optional | space-delimited, e.g. "AdGroupType FrequencyCapSettings" | |
- Anfragetext (JSON)
CampaignIdGanzzahlErforderlichfrom Campaigns/QueryByAccountId
Beispiel:
987654321ReturnAdditionalFieldsZeichenketteOptionalspace-delimited, e.g. "AdGroupType FrequencyCapSettings"
Codebeispiele
Ersetze $TOOLSWITCH_KEY durch den in der Konsole erstellten Schlüssel.
Beta
curl -X POST 'https://toolswitch.dev/v1/tools/microsoft-ads.adgroups' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"POST",
"https://toolswitch.dev/v1/tools/microsoft-ads.adgroups",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/microsoft-ads.adgroups", {
method: "POST",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());Diese Gateway-API ist in der Beta; URL und Authentifizierung können sich ändern. Die Beispielparameter sind Musterdaten. Aufrufe werden mit free einschließlich Servicegebühr abgerechnet.