SearchPartnerLinksRequest göndererek PartnerLink kaynaklarını alma
İsteğin parent alanı zorunludur. parent değerini, aşağıdaki biçimi kullanarak belirli bir hesabın kaynak adı olarak 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ıyla tanımlanan hesappartner_accountalanıyla 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ı döndürür. Bir isteğin tüm kaynaklarını almak için next_page_token değerini kontrol edin ve sonuçları sayfalara ayırın.
İstek başlıklarını ayarlama
Search yöntemi, istekte parent hesabına ait kimlik bilgilerinizin erişim yolunu tanımlamak için login-account başlığını destekler. linked-account başlığı, PartnerLinkService yöntemleri için desteklenmez.
Farklı erişim senaryoları için üstbilgilerin nasıl ayarlanacağıyla ilgili ayrıntılar ve talimatlar için Hedefler ve üstbilgiler bölümüne bakın.
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şul grubunu ve API'nin koşulları AND veya OR kullanarak birleştirip birleştirmeyeceğini tanımlayan bir dizedir.
Filtreleme seçenekleri ve söz dizimi hakkında daha fazla bilgi için AIP-160: Filtreleme başlıklı makaleyi inceleyin.
filter, sahip hesabın veya iş ortağı hesabının account_id kullanılarak tanımlanabilir:
owning_account.account_id: Sahip hesabınaccount_iddeğeri.partner_account.account_id: İş ortağı hesabınınaccount_id.
Örneğin, sahip 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
filter için başka bir örnek: Bu, sahip hesabın hesap kimliğinin OWNING_ACCOUNT_ID 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
OR yerine AND kullanmak için bu filter değiştirildiğinde, döndürülen kaynaklar, hem sahip 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ırlanır:
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, 10'dan az sonuç döndürebilir.
Varsayılan page_size 50, maksimum değer ise 1.000'dir.
Tek bir yanıta sığmayacak kadar çok sonuç varsa yanıtta next_page_token bulunur. 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ıtta next_page_token alanı yoksa başka sonuç yok demektir.