<!--
{
  "documentType" : "article",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/Apple_Ads/ads",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Ads"
}
-->

# Ads

Assign an ad creative to an ad group.

## Discussion

You use an [`Ad`](/documentation/apple_ads/Ad) object to assign an ad creative to an ad group. You can assign one active ad per ad group. See also [Ad Rejection Reasons](/documentation/Apple_Ads/ad-rejection-reasons).

## Topics

### Ad Endpoints

[`Create an Ad`](/documentation/apple_ads/Create-an-Ad)

Creates an ad in an ad group with a creative.

[`Find Ads`](/documentation/apple_ads/Find-Ads)

Finds ads within a campaign by selector criteria.

[`Find Ads (org-level)`](/documentation/apple_ads/Find-Ads-(org-level))

Fetches ads within an organization by selector criteria.

[`Get an Ad`](/documentation/apple_ads/Get-an-Ad)

Fetches an ad assigned to an ad group by identifier.

[`Get All Ads`](/documentation/apple_ads/Get-All-Ads)

Fetches all ads assigned to an ad group.

[`Update an Ad`](/documentation/apple_ads/Update-an-Ad)

Updates an ad in an ad group.

[`Delete an Ad`](/documentation/apple_ads/Delete-an-Ad)

Deletes an ad from an ad group.

### Ad Request and Response Objects

[`object Ad`](/documentation/apple_ads/Ad)

The assignment of a creative to an ad group.

[`object AdCreate`](/documentation/apple_ads/AdCreate)

The request to create an ad, and assign a creative to an ad group.

[`object AdUpdate`](/documentation/apple_ads/AdUpdate)

The request to update an ad.

[`object AdResponse`](/documentation/apple_ads/AdResponse)

The response to an ad request.

[`object AdListResponse`](/documentation/apple_ads/AdListResponse)

The response to a request that returns a list of ads.

### Data Types

[`string AdServingStateReasons`](/documentation/apple_ads/AdServingStateReasons)

Reasons the system provides when an ad isn’t running.

[`string AdStatus`](/documentation/apple_ads/AdStatus)

The user-controlled status of the ad.

[`string AdServingStatus`](/documentation/apple_ads/AdServingStatus)

The status of whether the ad is serving.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)