SearchPartnerLinksRequest göndererek PartnerLink kaynaklarını alın.
İsteğin parent alanı zorunludur. parent öğesini, şu biçimi kullanarak belirli bir hesabın kaynak adına ayarlayın:
accountTypes/{account_type}/accounts/{account}
Farklı kullanım alanlarında esneklik sağlamak için SearchPartnerLinksResponse, istekteki parent değerinin aşağıdakilerden biri olduğu tüm PartnerLink kaynaklarını içerir:
owner_accountalanı tarafından tanımlanan hesappartner_accountalanı tarafından tanımlanan hesap
parent hesabına bir iş ortağı bağlantısı, üst Google Ads yönetici hesabı veya üst Display & Video 360 iş ortağı hesabı kullanarak erişiyorsanız istek başlıklarını ayarlayın.
Yanıtı belirli özelliklere sahip kaynaklarla sınırlamak için sonuçları filtreleyin.
Search yöntemi, sonuç sayfalarını döndürür. Bir istekle ilgili tüm kaynakları almak için next_page_token işaretini kaldırın ve sonuçları sayfalandırın.
İstek üst bilgilerini ayarlama
Search yöntemi, kimlik bilgilerinizin parent hesabına erişim yolunu istekte tanımlamak için login-account ve linked-account üstbilgilerini destekler. Farklı erişim senaryolarında üstbilgilerin nasıl ayarlanacağıyla ilgili ayrıntılar ve talimatlar için Hedefler ve üstbilgiler başlıklı makaleyi inceleyin.
Sonuçları filtrele
Belirli iş ortağı bağlantılarını almak için isteğin filter alanını kullanın. filter alanı, uygulamak istediğiniz koşullar grubunu tanımlayan bir dizedir. Ayrıca, API'nin koşulları AND veya OR kullanarak birleştirip birleştirmeyeceğini de tanımlar.
Filtreleme seçenekleri ve söz dizimi hakkında daha fazla bilgiyi AIP-160: Filtreleme başlıklı makalede bulabilirsiniz.
filter değerini, sahip hesabının veya iş ortağı hesabının account_id değerini kullanarak tanımlayabilirsiniz:
owning_account.account_id: Sahip hesabınaccount_id.partner_account.account_id: İş ortağı hesabınınaccount_id.
Örneğin, sahip olan hesabın hesap kimliğinin OWNING_ACCOUNT_ID olduğu tüm iş ortağı bağlantılarını döndüren bir filter aşağıda verilmiştir:
owning_account.account_id = OWNING_ACCOUNT_ID
Başka bir filter örneğini aşağıda görebilirsiniz. Bu işlev, sahip olan hesabın hesap kimliğinin OWNING_ACCOUNT_ID olduğu veya iş ortağı hesabının hesap kimliğinin PARTNER_ACCOUNT_ID olduğu tüm iş ortağı bağlantılarını döndürür:
owning_account.account_id = OWNING_ACCOUNT_ID OR partner_account.account_id = PARTNER_ACCOUNT_ID
Bu filter değerini OR yerine AND kullanacak şekilde değiştirmek, döndürülen kaynakları, hem sahip olan hesabın hesap kimliğinin OWNING_ACCOUNT_ID hem de iş ortağı hesabının hesap kimliğinin PARTNER_ACCOUNT_ID olduğu iş ortağı bağlantılarıyla sınırlar:
owning_account.account_id = OWNING_ACCOUNT_ID AND partner_account.account_id = PARTNER_ACCOUNT_ID
Sonuçları sayfalandırma
Tek bir yanıtta döndürülen sonuç sayısını kontrol etmek için page_size alanını kullanın. Örneğin, page_size değerini 10 olarak ayarlarsanız API, yanıt başına en fazla 10 sonuç döndürür. İsteğinizle eşleşen 10'dan az sonuç varsa API'nin 10'dan az sonuç döndürmesi mümkündür.
Varsayılan page_size değeri 50, maksimum değeri ise 1.000'dir.
Tek bir yanıta sığabilecekten daha fazla sonuç varsa yanıtta next_page_token simgesi yer alır. Sonraki sayfayı veya sonuç grubunu almak için page_token alanı bu değere ayarlanmış şekilde aynı isteği tekrar gönderin. Diğer tüm parametreler önceki istekle aynı olmalıdır.
Yanıt next_page_token alanını içermiyorsa başka sonuç olmadığı anlaşılır.