RE: how to manage the pin position in the ad

['Google Ads API Forum Advisor' via Google Ads API and AdWords API Forum]

Hi,

Thank you for reaching out to the Google Ads API support team.

I understand that you are looking for guidance in setting the pin position for 
headlines and descriptions using the Google Ads API. I would recommend using 
the adGroupAds method and set the 'pinnedField' and select the position as per 
your requirement. We have tried this approach and were able to set the pin 
positions for both the headlines and descriptions using the Google Ads API. 
However, I am attaching the sample request and response logs for your reference.

Request Body:

POST https://googleads.googleapis.com/v17/customers/{customer 
ID}/adGroupAds:mutate?key=[YOUR_API_KEY] HTTP/1.1

developer-token: **********************
Authorization: Bearer [YOUR_ACCESS_TOKEN]
Accept: application/json
Content-Type: application/json

{
  "operations": [
    {
      "create": {
        "ad": {
          "responsiveSearchAd": {
            "descriptions": [
              {
                "text": "dfgtrh dfegtght",
                "pinnedField": "DESCRIPTION_2"
              },
              {
                "text": "sdfwed",
                "pinnedField": "DESCRIPTION_1"
              }
            ],
            "headlines": [
              {
                "pinnedField": "HEADLINE_1",
                "text": "good one"
              },
              {
                "text": "safewv",
                "pinnedField": "HEADLINE_2"
              },
              {
                "text": "sadfewfewf",
                "pinnedField": "HEADLINE_3"
              }
            ]
          },
          "finalUrls": [
            "https://www.example.com";
          ]
        },
        "adGroup": "customers/{customer ID}/adGroups/{ad_group_ID}"
      }
    }
  ]
}

Response:

HTTP/1.1 200 
cache-control: private
content-encoding: gzip
content-length: 123
content-type: application/json; charset=UTF-8
date: Mon, 16 Sep 2024 11:35:39 GMT
server: ESF
vary: Origin, X-Origin, Referer

{
  "results": [
    {
      "resourceName": "customers/{customer ID}/adGroupAds/{ad_group_id}~{ad_ID}"
    }
  ]
}

I hope this helps.
This message is in relation to case "ref:!00D1U01174p.!5004Q02vG9Fi:ref" 
(ADR-00268195)

Thanks,

Google Ads API Team

-- 
-- 
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog:
https://googleadsdeveloper.blogspot.com/
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~

You received this message because you are subscribed to the Google
Groups "AdWords API and Google Ads API Forum" group.
To post to this group, send email to adwords-api@googlegroups.com
To unsubscribe from this group, send email to
adwords-api+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/adwords-api?hl=en
--- 
You received this message because you are subscribed to the Google Groups 
"Google Ads API and AdWords API Forum" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to adwords-api+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/adwords-api/sTH63000000000000000000000000000000000000000000000SJWM9D00hb-C-gotQQ-aRKW6tTqAbA%40sfdc.net.