Mutation Reference

Mutation Reference

Detailed parameter reference for all 62 write operations.

Campaign Operations

create_campaign

Parameter	Type	Required	Description
name	string	Yes	Campaign name
budgetAmountDollars	number	Yes	Daily budget in dollars
channelType	string	No	SEARCH, DISPLAY, SHOPPING, PERFORMANCE_MAX, VIDEO, DEMAND_GEN
biddingStrategy	string	No	MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_CPA, TARGET_ROAS, MANUAL_CPC, MAXIMIZE_CLICKS
targetCpa	number	No	Target CPA in micros (for TARGET_CPA)
targetRoas	number	No	Target ROAS multiplier (for TARGET_ROAS)
status	string	No	PAUSED (default) or ENABLED
merchantId	string	No	Merchant Center ID (for Shopping/PMax)
feedLabel	string	No	Feed label (for Shopping)
searchPartners	boolean	No	Include search partners

update_campaign_status

Parameter	Type	Required
campaignId	string	Yes
status	string	Yes (ENABLED or PAUSED)

remove_campaign

Parameter	Type	Required
campaignId	string	Yes

update_campaign_targeting

Parameter	Type	Required
campaignId	string	Yes
name	string	No
targetCpa	number	No
targetRoas	number	No

update_bidding_strategy

Parameter	Type	Required
campaignId	string	Yes
biddingStrategy	string	Yes
targetCpa	number	No
targetRoas	number	No
targetCpaDollars	number	No
enhancedCpc	boolean	No

---

Budget Operations

update_budget

Parameter	Type	Required
budgetId	string	Yes
amountDollars	number	Yes

create_shared_budget

Parameter	Type	Required
name	string	Yes
amountDollars	number	Yes
deliveryMethod	string	No

update_shared_budget

Parameter	Type	Required
budgetId	string	Yes
amountDollars	number	No
name	string	No

assign_shared_budget

Parameter	Type	Required
campaignId	string	Yes
budgetId	string	Yes

---

Ad Group Operations

create_ad_group

Parameter	Type	Required
campaignId	string	Yes
name	string	Yes
cpcBidDollars	number	No
type	string	No
status	string	No

update_ad_group

Parameter	Type	Required
adGroupId	string	Yes
status	string	No
cpcBidMicros	number	No
name	string	No

remove_ad_group

Parameter	Type	Required
adGroupId	string	Yes

---

Ad Operations

create_ad (RSA)

Parameter	Type	Required
adGroupId	string	Yes
headlines	array	Yes (up to 15, max 30 chars each)
descriptions	array	Yes (up to 4, max 90 chars each)
finalUrl	string	Yes
path1	string	No (max 15 chars)
path2	string	No (max 15 chars)

create_display_ad (Responsive Display Ad)

Parameter	Type	Required
adGroupId	string	Yes
headlines	array	No
longHeadline	string	No
descriptions	array	No
businessName	string	No
finalUrl	string	No
marketingImageAssetIds	array	No
squareImageAssetIds	array	No
logoAssetIds	array	No

update_rsa

Parameter	Type	Required
adGroupId	string	Yes
adId	string	Yes
headlines	array	Yes
descriptions	array	Yes
finalUrl	string	Yes
path1	string	No
path2	string	No

update_ad_status

Parameter	Type	Required
adGroupId	string	Yes
adId	string	Yes
status	string	Yes (ENABLED or PAUSED)

remove_ad

Parameter	Type	Required
adGroupId	string	Yes
adId	string	Yes

---

Keyword Operations

create_keyword

Parameter	Type	Required
adGroupId	string	Yes
keyword	string	Yes
matchType	string	No (BROAD, PHRASE, EXACT)
cpcBidDollars	number	No
finalUrl	string	No

update_keyword_status

Parameter	Type	Required
criterionId	string	Yes
adGroupId	string	Yes
status	string	Yes

update_keyword_bid

Parameter	Type	Required
adGroupId	string	Yes
criterionId	string	Yes
cpcBidMicros	number	Yes

remove_keyword

Parameter	Type	Required
adGroupId	string	Yes
criterionId	string	Yes

create_negative_keyword

Parameter	Type	Required
campaignId	string	Yes
keyword	string	Yes
matchType	string	No

remove_negative_keyword

Parameter	Type	Required
campaignId	string	Yes
criterionId	string	Yes

---

Extension Operations

create_sitelink

Parameter	Type	Required
campaignId	string	Yes
linkText	string	Yes
finalUrl	string	Yes
description1	string	No
description2	string	No

create_callout

Parameter	Type	Required
calloutText	string	Yes

create_structured_snippet

Parameter	Type	Required
header	string	Yes
values	array	Yes (3+ items)
campaignId	string	No

create_call_extension

Parameter	Type	Required
phoneNumber	string	Yes
countryCode	string	Yes
campaignId	string	No
callTrackingEnabled	boolean	No

create_price_extension

Parameter	Type	Required
type	string	Yes
priceOfferings	array	Yes (3+ items)
campaignId	string	No
currency	string	No
language	string	No

create_promotion_extension

Parameter	Type	Required
promotionTarget	string	Yes
finalUrl	string	Yes
campaignId	string	No
percentOff	number	No
moneyOff	number	No
discountModifier	string	No
occasion	string	No
promotionCode	string	No

create_lead_form_extension

Parameter	Type	Required
headline	string	Yes
businessName	string	Yes
description	string	Yes
privacyPolicyUrl	string	Yes
fields	array	Yes
callToActionType	string	No
deliveryMethods	array	No

create_image_extension

Parameter	Type	Required
imageUrl	string	Yes
campaignId	string	No
name	string	No

---

Conversion Operations

create_conversion_action

Parameter	Type	Required
name	string	Yes
type	string	Yes
category	string	Yes
countingType	string	No
defaultValue	number	No
defaultCurrency	string	No
viewThroughDays	number	No
clickThroughDays	number	No
attributionModel	string	No

update_conversion_action

Parameter	Type	Required
conversionActionId	string	Yes
name	string	No
status	string	No
category	string	No
countingType	string	No

---

Experiment Operations

create_experiment

Parameter	Type	Required
name	string	Yes
campaignId	string	Yes
trafficSplitPercent	number	Yes
description	string	No
startDate	string	No
endDate	string	No

start_experiment / end_experiment

Parameter	Type	Required
experimentId	string	Yes
promoteVariant	boolean	No (end only)

---

PMax Operations

create_asset_group

Parameter	Type	Required
campaignId	string	Yes
name	string	Yes
finalUrl	string	No
headlines	array	No
descriptions	array	No
businessName	string	No

add_asset_to_group / remove_asset_from_group

Parameter	Type	Required
assetGroupId	string	Yes
assetId	string	Yes
fieldType	string	Yes

upload_image_asset

Parameter	Type	Required
imageData	string	Yes (base64)
name	string	Yes

create_text_asset

Parameter	Type	Required
text	string	Yes

---

Merchant Center Operations

Action	Required Params
mc_insert_product	merchantId, product
mc_list_products	merchantId
mc_update_product	merchantId, productId, updates
mc_delete_product	merchantId, productId
mc_get_product_status	merchantId